Wed Nov 20 13:18:49 UTC 2024 I: starting to build starlink-ast/unstable/i386 on jenkins on '2024-11-20 13:18' Wed Nov 20 13:18:49 UTC 2024 I: The jenkins build log is/was available at https://jenkins.debian.net/userContent/reproducible/debian/build_service/i386_12/29576/console.log Wed Nov 20 13:18:49 UTC 2024 I: Downloading source for unstable/starlink-ast=9.2.10+dfsg-2 --2024-11-20 13:18:50-- http://deb.debian.org/debian/pool/main/s/starlink-ast/starlink-ast_9.2.10%2bdfsg-2.dsc Connecting to 46.16.76.132:3128... connected. Proxy request sent, awaiting response... 200 OK Length: 2553 (2.5K) [text/prs.lines.tag] Saving to: ‘starlink-ast_9.2.10+dfsg-2.dsc’ 0K .. 100% 310M=0s 2024-11-20 13:18:50 (310 MB/s) - ‘starlink-ast_9.2.10+dfsg-2.dsc’ saved [2553/2553] Wed Nov 20 13:18:50 UTC 2024 I: starlink-ast_9.2.10+dfsg-2.dsc -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Format: 3.0 (quilt) Source: starlink-ast Binary: libstarlink-ast-dev, libstarlink-ast9, libstarlink-ast-grf3d9, libstarlink-ast-err9, libstarlink-ast-doc Architecture: any all Version: 9.2.10+dfsg-2 Maintainer: Debian Astro Team Uploaders: Ole Streicher Homepage: https://starlink.eao.hawaii.edu/starlink/AST Standards-Version: 4.7.0 Vcs-Browser: https://salsa.debian.org/debian-astro-team/starlink-ast Vcs-Git: https://salsa.debian.org/debian-astro-team/starlink-ast.git Testsuite: autopkgtest Testsuite-Triggers: build-essential Build-Depends: debhelper-compat (= 13), libcminpack-dev, liberfa-dev, libstarlink-pal-dev Build-Depends-Indep: ghostscript, latex2html, perl, texlive, texlive-font-utils, texlive-latex-extra, texlive-science Package-List: libstarlink-ast-dev deb libdevel optional arch=any libstarlink-ast-doc deb doc optional arch=all libstarlink-ast-err9 deb libs optional arch=any libstarlink-ast-grf3d9 deb libs optional arch=any libstarlink-ast9 deb libs optional arch=any Checksums-Sha1: 2db14b497c589528a3453dae9e119f8446fb5119 4023704 starlink-ast_9.2.10+dfsg.orig.tar.xz 604ba2a1a4468cb911eedaabf76281e57bd1c446 22908 starlink-ast_9.2.10+dfsg-2.debian.tar.xz Checksums-Sha256: 84d04a93789279b85f9fce7895fdc1f0c0bfe7cad6eb1ea9b7cd41ea8843c5e5 4023704 starlink-ast_9.2.10+dfsg.orig.tar.xz 6094847ac829f85b05eb7cf01e898d8d96ac05fa0ee925fc6f135bf08517c6f8 22908 starlink-ast_9.2.10+dfsg-2.debian.tar.xz Files: 1f38a44d789c0becd6db0b0d062014f6 4023704 starlink-ast_9.2.10+dfsg.orig.tar.xz 44d09d7ed6cca48a170d50628466dd4b 22908 starlink-ast_9.2.10+dfsg-2.debian.tar.xz -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEEuvxshffLFD/utvsVcRWv0HcQ3PcFAmcDkgUACgkQcRWv0HcQ 3PcqQw//Tq10KtPk44hjzywuZGSiQSblSQ3xYZYp9PBEfiDece5B423zi9C++A1L NR857vL805/nHPcNMKuCXWr3fbwLufdeUWYhf5HppvImCUdxqQVtLRgaEnA1YnQL RuFEddg7kwuTO0GgtqitmB3rjuS1CoSXxXiyst3yDYhDvLpBtN90hC5oWzGMThWV w5gO75LbsMeS7bwKpyzBpuCOUXUA/wu6Lv+p4/i+pV6/nXuM1Ijfeu7EzwPhE4rW l2tSp9pMCj7GpFOtl5xXW0HESCvHRhfVE/PmK0EVK+0MplHy7jN8egVmoqz6DBEV six18hO+HtvaHFhFM7c/E5HQmjsUIfpa2aEDH9oGDn/FHp3sud64o4+roOOKXNtA CzhBhYvJXF1rpOQMPGStkv6kubyrWvt4h1zU7xsrPI4PIzUNptqNiaw+pmaeWxC3 BuY7xYQHVomk+3wQ1pywzEWXXelDb/1rboL+kYLcKl+7FbDOYkaUKXwG0PLg0WgY P6p+pHpc7XX/fPmLkURbdzkugiuOGWsqu6pMOMR/1dAymfSr+HLEBFtHavcgJ+Tu HYsXiPaoGFhWjvurb+gbLtbnm2AfAF/BT/clIDnhxncc2pydhQ2BvisuvfKEXRQf b0PIyOxEz6FD+6R9t7e2vDEeC8xU7SkXlzsW04T9pVVxHDC732g= =v0Qa -----END PGP SIGNATURE----- Wed Nov 20 13:18:50 UTC 2024 I: Checking whether the package is not for us Wed Nov 20 13:18:50 UTC 2024 I: Starting 1st build on remote node ionos12-i386.debian.net. Wed Nov 20 13:18:50 UTC 2024 I: Preparing to do remote build '1' on ionos12-i386.debian.net. Wed Nov 20 13:35:42 UTC 2024 I: Deleting $TMPDIR on ionos12-i386.debian.net. I: pbuilder: network access will be disabled during build I: Current time: Wed Nov 20 01:18:52 -12 2024 I: pbuilder-time-stamp: 1732108732 I: Building the build Environment I: extracting base tarball [/var/cache/pbuilder/unstable-reproducible-base.tgz] I: copying local configuration W: --override-config is not set; not updating apt.conf Read the manpage for details. 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: using eatmydata during job I: Copying source file I: copying [starlink-ast_9.2.10+dfsg-2.dsc] I: copying [./starlink-ast_9.2.10+dfsg.orig.tar.xz] I: copying [./starlink-ast_9.2.10+dfsg-2.debian.tar.xz] I: Extracting source gpgv: Signature made Mon Oct 7 07:47:17 2024 gpgv: using RSA key BAFC6C85F7CB143FEEB6FB157115AFD07710DCF7 gpgv: Can't check signature: No public key dpkg-source: warning: cannot verify inline signature for ./starlink-ast_9.2.10+dfsg-2.dsc: no acceptable signature found dpkg-source: info: extracting starlink-ast in starlink-ast-9.2.10+dfsg dpkg-source: info: unpacking starlink-ast_9.2.10+dfsg.orig.tar.xz dpkg-source: info: unpacking starlink-ast_9.2.10+dfsg-2.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 workround_armhf_compiler_bug.patch dpkg-source: info: applying Disable-tests.patch dpkg-source: info: applying Check-the-values-returned-by-the-test.patch dpkg-source: info: applying reproducible.patch dpkg-source: info: applying Adjust-starlink.csl-for-changes-in-Debian-s-LaTeX-distrib.patch I: Not using root during the build. I: Installing the build-deps I: user script /srv/workspace/pbuilder/33987/tmp/hooks/D02_print_environment starting I: set BUILDDIR='/build/reproducible-path' BUILDUSERGECOS='first user,first room,first work-phone,first home-phone,first other' BUILDUSERNAME='pbuilder1' BUILD_ARCH='i386' DEBIAN_FRONTEND='noninteractive' DEB_BUILD_OPTIONS='buildinfo=+all reproducible=+all parallel=11 ' DISTRIBUTION='unstable' HOME='/root' HOST_ARCH='i386' IFS=' ' INVOCATION_ID='ae4f7e4c5b764f71a5b72a79128c8fe3' LANG='C' LANGUAGE='en_US:en' LC_ALL='C' LD_LIBRARY_PATH='/usr/lib/libeatmydata' LD_PRELOAD='libeatmydata.so' MAIL='/var/mail/root' OPTIND='1' PATH='/usr/sbin:/usr/bin:/sbin:/bin:/usr/games' PBCURRENTCOMMANDLINEOPERATION='build' PBUILDER_OPERATION='build' PBUILDER_PKGDATADIR='/usr/share/pbuilder' PBUILDER_PKGLIBDIR='/usr/lib/pbuilder' PBUILDER_SYSCONFDIR='/etc' PPID='33987' PS1='# ' PS2='> ' PS4='+ ' PWD='/' SHELL='/bin/bash' SHLVL='2' SUDO_COMMAND='/usr/bin/timeout -k 18.1h 18h /usr/bin/ionice -c 3 /usr/bin/nice /usr/sbin/pbuilder --build --configfile /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/pbuilderrc_1BbW --distribution unstable --hookdir /etc/pbuilder/first-build-hooks --debbuildopts -b --basetgz /var/cache/pbuilder/unstable-reproducible-base.tgz --buildresult /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/b1 --logfile b1/build.log starlink-ast_9.2.10+dfsg-2.dsc' SUDO_GID='112' SUDO_UID='107' SUDO_USER='jenkins' TERM='unknown' TZ='/usr/share/zoneinfo/Etc/GMT+12' USER='root' _='/usr/bin/systemd-run' http_proxy='http://46.16.76.132:3128' I: uname -a Linux ionos12-i386 6.1.0-27-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.115-1 (2024-11-01) x86_64 GNU/Linux I: ls -l /bin lrwxrwxrwx 1 root root 7 Aug 4 21:30 /bin -> usr/bin I: user script /srv/workspace/pbuilder/33987/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: i386 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: debhelper-compat (= 13), libcminpack-dev, liberfa-dev, libstarlink-pal-dev, ghostscript, latex2html, perl, 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 ... 19952 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 debhelper-compat (= 13); however: Package debhelper-compat is not installed. pbuilder-satisfydepends-dummy depends on libcminpack-dev; however: Package libcminpack-dev 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} bsdextrautils{a} debhelper{a} dh-autoreconf{a} dh-strip-nondeterminism{a} dirmngr{a} dwz{a} file{a} fontconfig-config{a} fonts-gfs-baskerville{a} fonts-gfs-porson{a} fonts-lmodern{a} fonts-urw-base35{a} gettext{a} gettext-base{a} ghostscript{a} gnupg{a} gnupg-l10n{a} gpg{a} gpg-agent{a} gpgconf{a} gpgsm{a} groff-base{a} intltool-debian{a} latex2html{a} libapache-pom-java{a} libarchive-zip-perl{a} libassuan9{a} libavahi-client3{a} libavahi-common-data{a} libavahi-common3{a} libbrotli1{a} libcairo2{a} libcminpack-dev{a} libcminpack1{a} libcom-err2{a} libcommons-logging-java{a} libcommons-parent-java{a} libcups2t64{a} libcurl3t64-gnutls{a} libdbus-1-3{a} libdebhelper-perl{a} libdeflate0{a} libelf1t64{a} liberfa-dev{a} liberfa1{a} libexpat1{a} libfile-stripnondeterminism-perl{a} libfontbox-java{a} libfontconfig1{a} libfontenc1{a} libfreetype6{a} libglib2.0-0t64{a} libgpgme11t64{a} libgpgmepp6t64{a} libgraphite2-3{a} libgs-common{a} libgs10{a} libgs10-common{a} libgssapi-krb5-2{a} libharfbuzz0b{a} libice6{a} libicu72{a} libidn12{a} libijs-0.35{a} libjbig0{a} libjbig2dec0{a} libjpeg62-turbo{a} libk5crypto3{a} libkeyutils1{a} libkpathsea6{a} libkrb5-3{a} libkrb5support0{a} libksba8{a} liblcms2-2{a} libldap-2.5-0{a} liblerc4{a} libmagic-mgc{a} libmagic1t64{a} libmpfi0{a} libnetpbm11t64{a} libnghttp2-14{a} libnghttp3-9{a} libngtcp2-16{a} libngtcp2-crypto-gnutls8{a} libnpth0t64{a} libnsl2{a} libnspr4{a} libnss3{a} libopenjp2-7{a} libpaper-utils{a} libpaper1{a} libpdfbox-java{a} libpipeline1{a} libpixman-1-0{a} libpng16-16t64{a} libpoppler140{a} libpotrace0{a} libpsl5t64{a} libptexenc1{a} libpython3-stdlib{a} libpython3.12-minimal{a} libpython3.12-stdlib{a} libreadline8t64{a} librtmp1{a} libsasl2-2{a} libsasl2-modules-db{a} libsharpyuv0{a} libsm6{a} libssh2-1t64{a} libstarlink-pal-dev{a} libstarlink-pal0{a} libsynctex2{a} libteckit0{a} libtexlua53-5{a} libtiff6{a} libtirpc-common{a} libtirpc3t64{a} libtool{a} libuchardet0{a} libwebp7{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} libxt6t64{a} libzzip-0-13t64{a} m4{a} man-db{a} media-types{a} netbase{a} netpbm{a} perl-doc{a} pinentry-curses{a} po-debconf{a} poppler-data{a} poppler-utils{a} preview-latex-style{a} python3{a} python3-minimal{a} python3.12{a} python3.12-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} tzdata{a} ucf{a} x11-common{a} xdg-utils{a} xfonts-encodings{a} xfonts-utils{a} The following packages are RECOMMENDED but will NOT be installed: ca-certificates curl dbus default-jre dvipng dvisvgm fonts-droid-fallback gnupg-utils gpg-wks-client krb5-locales libarchive-cpio-perl libfile-mimeinfo-perl libglib2.0-data libldap-common libltdl-dev libmail-sendmail-perl libnet-dbus-perl libsasl2-modules libspreadsheet-parseexcel-perl libx11-protocol-perl lmodern lynx minpack-dev ps2eps publicsuffix ruby shared-mime-info tex-gyre texlive-plain-generic tipa tk wget x11-utils x11-xserver-utils xdg-user-dirs 0 packages upgraded, 176 newly installed, 0 to remove and 0 not upgraded. Need to get 266 MB of archives. After unpacking 712 MB will be used. Writing extended state information... Get: 1 http://deb.debian.org/debian unstable/main i386 poppler-data all 0.4.12-1 [1601 kB] Get: 2 http://deb.debian.org/debian unstable/main i386 libpython3.12-minimal i386 3.12.7-3 [814 kB] Get: 3 http://deb.debian.org/debian unstable/main i386 libexpat1 i386 2.6.4-1 [107 kB] Get: 4 http://deb.debian.org/debian unstable/main i386 python3.12-minimal i386 3.12.7-3 [2236 kB] Get: 5 http://deb.debian.org/debian unstable/main i386 python3-minimal i386 3.12.7-1 [26.8 kB] Get: 6 http://deb.debian.org/debian unstable/main i386 media-types all 10.1.0 [26.9 kB] Get: 7 http://deb.debian.org/debian unstable/main i386 netbase all 6.4 [12.8 kB] Get: 8 http://deb.debian.org/debian unstable/main i386 tzdata all 2024b-3 [255 kB] Get: 9 http://deb.debian.org/debian unstable/main i386 libkrb5support0 i386 1.21.3-3 [34.9 kB] Get: 10 http://deb.debian.org/debian unstable/main i386 libcom-err2 i386 1.47.1-1+b1 [23.4 kB] Get: 11 http://deb.debian.org/debian unstable/main i386 libk5crypto3 i386 1.21.3-3 [83.6 kB] Get: 12 http://deb.debian.org/debian unstable/main i386 libkeyutils1 i386 1.6.3-4 [9600 B] Get: 13 http://deb.debian.org/debian unstable/main i386 libkrb5-3 i386 1.21.3-3 [350 kB] Get: 14 http://deb.debian.org/debian unstable/main i386 libgssapi-krb5-2 i386 1.21.3-3 [146 kB] Get: 15 http://deb.debian.org/debian unstable/main i386 libtirpc-common all 1.3.4+ds-1.3 [10.9 kB] Get: 16 http://deb.debian.org/debian unstable/main i386 libtirpc3t64 i386 1.3.4+ds-1.3+b1 [90.5 kB] Get: 17 http://deb.debian.org/debian unstable/main i386 libnsl2 i386 1.3.0-3+b3 [42.7 kB] Get: 18 http://deb.debian.org/debian unstable/main i386 readline-common all 8.2-5 [69.3 kB] Get: 19 http://deb.debian.org/debian unstable/main i386 libreadline8t64 i386 8.2-5 [173 kB] Get: 20 http://deb.debian.org/debian unstable/main i386 libpython3.12-stdlib i386 3.12.7-3 [1964 kB] Get: 21 http://deb.debian.org/debian unstable/main i386 python3.12 i386 3.12.7-3 [671 kB] Get: 22 http://deb.debian.org/debian unstable/main i386 libpython3-stdlib i386 3.12.7-1 [9712 B] Get: 23 http://deb.debian.org/debian unstable/main i386 python3 i386 3.12.7-1 [27.8 kB] Get: 24 http://deb.debian.org/debian unstable/main i386 sensible-utils all 0.0.24 [24.8 kB] Get: 25 http://deb.debian.org/debian unstable/main i386 libmagic-mgc i386 1:5.45-3+b1 [314 kB] Get: 26 http://deb.debian.org/debian unstable/main i386 libmagic1t64 i386 1:5.45-3+b1 [115 kB] Get: 27 http://deb.debian.org/debian unstable/main i386 file i386 1:5.45-3+b1 [43.2 kB] Get: 28 http://deb.debian.org/debian unstable/main i386 gettext-base i386 0.22.5-2 [201 kB] Get: 29 http://deb.debian.org/debian unstable/main i386 libuchardet0 i386 0.0.8-1+b2 [69.2 kB] Get: 30 http://deb.debian.org/debian unstable/main i386 groff-base i386 1.23.0-5 [1196 kB] Get: 31 http://deb.debian.org/debian unstable/main i386 bsdextrautils i386 2.40.2-11 [95.6 kB] Get: 32 http://deb.debian.org/debian unstable/main i386 libpipeline1 i386 1.5.8-1 [41.2 kB] Get: 33 http://deb.debian.org/debian unstable/main i386 man-db i386 2.13.0-1 [1428 kB] Get: 34 http://deb.debian.org/debian unstable/main i386 ucf all 3.0043+nmu1 [55.2 kB] Get: 35 http://deb.debian.org/debian unstable/main i386 m4 i386 1.4.19-4 [293 kB] Get: 36 http://deb.debian.org/debian unstable/main i386 autoconf all 2.72-3 [493 kB] Get: 37 http://deb.debian.org/debian unstable/main i386 autotools-dev all 20220109.1 [51.6 kB] Get: 38 http://deb.debian.org/debian unstable/main i386 automake all 1:1.16.5-1.3 [823 kB] Get: 39 http://deb.debian.org/debian unstable/main i386 autopoint all 0.22.5-2 [723 kB] Get: 40 http://deb.debian.org/debian unstable/main i386 libdebhelper-perl all 13.20 [89.7 kB] Get: 41 http://deb.debian.org/debian unstable/main i386 libtool all 2.4.7-8 [517 kB] Get: 42 http://deb.debian.org/debian unstable/main i386 dh-autoreconf all 20 [17.1 kB] Get: 43 http://deb.debian.org/debian unstable/main i386 libarchive-zip-perl all 1.68-1 [104 kB] Get: 44 http://deb.debian.org/debian unstable/main i386 libfile-stripnondeterminism-perl all 1.14.0-1 [19.5 kB] Get: 45 http://deb.debian.org/debian unstable/main i386 dh-strip-nondeterminism all 1.14.0-1 [8448 B] Get: 46 http://deb.debian.org/debian unstable/main i386 libelf1t64 i386 0.192-4 [195 kB] Get: 47 http://deb.debian.org/debian unstable/main i386 dwz i386 0.15-1+b1 [116 kB] Get: 48 http://deb.debian.org/debian unstable/main i386 libicu72 i386 72.1-5+b1 [9583 kB] Get: 49 http://deb.debian.org/debian unstable/main i386 libxml2 i386 2.12.7+dfsg+really2.9.14-0.2+b1 [734 kB] Get: 50 http://deb.debian.org/debian unstable/main i386 gettext i386 0.22.5-2 [1631 kB] Get: 51 http://deb.debian.org/debian unstable/main i386 intltool-debian all 0.35.0+20060710.6 [22.9 kB] Get: 52 http://deb.debian.org/debian unstable/main i386 po-debconf all 1.0.21+nmu1 [248 kB] Get: 53 http://deb.debian.org/debian unstable/main i386 debhelper all 13.20 [915 kB] Get: 54 http://deb.debian.org/debian unstable/main i386 libassuan9 i386 3.0.1-2 [62.4 kB] Get: 55 http://deb.debian.org/debian unstable/main i386 gpgconf i386 2.2.45-2 [127 kB] Get: 56 http://deb.debian.org/debian unstable/main i386 libksba8 i386 1.6.7-2+b1 [142 kB] Get: 57 http://deb.debian.org/debian unstable/main i386 libsasl2-modules-db i386 2.1.28+dfsg1-8 [20.6 kB] Get: 58 http://deb.debian.org/debian unstable/main i386 libsasl2-2 i386 2.1.28+dfsg1-8 [61.0 kB] Get: 59 http://deb.debian.org/debian unstable/main i386 libldap-2.5-0 i386 2.5.18+dfsg-3+b1 [200 kB] Get: 60 http://deb.debian.org/debian unstable/main i386 libnpth0t64 i386 1.6-3.1+b1 [18.3 kB] Get: 61 http://deb.debian.org/debian unstable/main i386 dirmngr i386 2.2.45-2 [396 kB] Get: 62 http://deb.debian.org/debian unstable/main i386 libfontenc1 i386 1:1.1.8-1+b1 [23.4 kB] Get: 63 http://deb.debian.org/debian unstable/main i386 libbrotli1 i386 1.1.0-2+b6 [308 kB] Get: 64 http://deb.debian.org/debian unstable/main i386 libpng16-16t64 i386 1.6.44-2 [288 kB] Get: 65 http://deb.debian.org/debian unstable/main i386 libfreetype6 i386 2.13.3+dfsg-1 [464 kB] Get: 66 http://deb.debian.org/debian unstable/main i386 x11-common all 1:7.7+23.1 [216 kB] Get: 67 http://deb.debian.org/debian unstable/main i386 xfonts-encodings all 1:1.0.4-2.2 [577 kB] Get: 68 http://deb.debian.org/debian unstable/main i386 xfonts-utils i386 1:7.7+7 [95.1 kB] Get: 69 http://deb.debian.org/debian unstable/main i386 fonts-urw-base35 all 20200910-8 [10.8 MB] Get: 70 http://deb.debian.org/debian unstable/main i386 fontconfig-config i386 2.15.0-1.1+b1 [318 kB] Get: 71 http://deb.debian.org/debian unstable/main i386 fonts-gfs-baskerville all 1.1-6 [43.7 kB] Get: 72 http://deb.debian.org/debian unstable/main i386 fonts-gfs-porson all 1.1-7 [33.8 kB] Get: 73 http://deb.debian.org/debian unstable/main i386 fonts-lmodern all 2.005-1 [4540 kB] Get: 74 http://deb.debian.org/debian unstable/main i386 libgs-common all 10.04.0~dfsg-1 [148 kB] Get: 75 http://deb.debian.org/debian unstable/main i386 libgs10-common all 10.04.0~dfsg-1 [474 kB] Get: 76 http://deb.debian.org/debian unstable/main i386 libavahi-common-data i386 0.8-13+b3 [112 kB] Get: 77 http://deb.debian.org/debian unstable/main i386 libavahi-common3 i386 0.8-13+b3 [45.2 kB] Get: 78 http://deb.debian.org/debian unstable/main i386 libdbus-1-3 i386 1.14.10-6 [217 kB] Get: 79 http://deb.debian.org/debian unstable/main i386 libavahi-client3 i386 0.8-13+b3 [49.6 kB] Get: 80 http://deb.debian.org/debian unstable/main i386 libcups2t64 i386 2.4.10-2 [267 kB] Get: 81 http://deb.debian.org/debian unstable/main i386 libfontconfig1 i386 2.15.0-1.1+b1 [402 kB] Get: 82 http://deb.debian.org/debian unstable/main i386 libidn12 i386 1.42-2+b1 [82.2 kB] Get: 83 http://deb.debian.org/debian unstable/main i386 libijs-0.35 i386 0.35-15.1+b2 [15.7 kB] Get: 84 http://deb.debian.org/debian unstable/main i386 libjbig2dec0 i386 0.20-1+b3 [67.0 kB] Get: 85 http://deb.debian.org/debian unstable/main i386 libjpeg62-turbo i386 1:2.1.5-3+b1 [171 kB] Get: 86 http://deb.debian.org/debian unstable/main i386 liblcms2-2 i386 2.16-2 [171 kB] Get: 87 http://deb.debian.org/debian unstable/main i386 libopenjp2-7 i386 2.5.0-2+b4 [210 kB] Get: 88 http://deb.debian.org/debian unstable/main i386 libpaper1 i386 1.1.29+b2 [13.0 kB] Get: 89 http://deb.debian.org/debian unstable/main i386 libdeflate0 i386 1.22-1 [48.1 kB] Get: 90 http://deb.debian.org/debian unstable/main i386 libjbig0 i386 2.1-6.1+b2 [32.2 kB] Get: 91 http://deb.debian.org/debian unstable/main i386 liblerc4 i386 4.0.0+ds-5 [191 kB] Get: 92 http://deb.debian.org/debian unstable/main i386 libsharpyuv0 i386 1.4.0-0.1+b1 [113 kB] Get: 93 http://deb.debian.org/debian unstable/main i386 libwebp7 i386 1.4.0-0.1+b1 [322 kB] Get: 94 http://deb.debian.org/debian unstable/main i386 libtiff6 i386 4.5.1+git230720-5 [339 kB] Get: 95 http://deb.debian.org/debian unstable/main i386 libxau6 i386 1:1.0.11-1 [20.7 kB] Get: 96 http://deb.debian.org/debian unstable/main i386 libxdmcp6 i386 1:1.1.5-1 [28.2 kB] Get: 97 http://deb.debian.org/debian unstable/main i386 libxcb1 i386 1.17.0-2+b1 [148 kB] Get: 98 http://deb.debian.org/debian unstable/main i386 libx11-data all 2:1.8.10-2 [337 kB] Get: 99 http://deb.debian.org/debian unstable/main i386 libx11-6 i386 2:1.8.10-2 [834 kB] Get: 100 http://deb.debian.org/debian unstable/main i386 libice6 i386 2:1.1.1-1 [67.8 kB] Get: 101 http://deb.debian.org/debian unstable/main i386 libsm6 i386 2:1.2.4-1 [35.9 kB] Get: 102 http://deb.debian.org/debian unstable/main i386 libxt6t64 i386 1:1.2.1-1.2+b1 [193 kB] Get: 103 http://deb.debian.org/debian unstable/main i386 libgs10 i386 10.04.0~dfsg-1 [2708 kB] Get: 104 http://deb.debian.org/debian unstable/main i386 ghostscript i386 10.04.0~dfsg-1 [50.3 kB] Get: 105 http://deb.debian.org/debian unstable/main i386 gnupg-l10n all 2.2.45-2 [705 kB] Get: 106 http://deb.debian.org/debian unstable/main i386 gpg i386 2.2.45-2 [573 kB] Get: 107 http://deb.debian.org/debian unstable/main i386 pinentry-curses i386 1.2.1-4+b1 [80.4 kB] Get: 108 http://deb.debian.org/debian unstable/main i386 gpg-agent i386 2.2.45-2 [269 kB] Get: 109 http://deb.debian.org/debian unstable/main i386 gpgsm i386 2.2.45-2 [275 kB] Get: 110 http://deb.debian.org/debian unstable/main i386 gnupg all 2.2.45-2 [376 kB] Get: 111 http://deb.debian.org/debian unstable/main i386 libnetpbm11t64 i386 2:11.08.01-1+b1 [189 kB] Get: 112 http://deb.debian.org/debian unstable/main i386 netpbm i386 2:11.08.01-1+b1 [2097 kB] Get: 113 http://deb.debian.org/debian unstable/main i386 perl-doc all 5.40.0-7 [8262 kB] Get: 114 http://deb.debian.org/debian unstable/main i386 libnghttp2-14 i386 1.64.0-1 [82.4 kB] Get: 115 http://deb.debian.org/debian unstable/main i386 libnghttp3-9 i386 1.4.0-1+b1 [74.9 kB] Get: 116 http://deb.debian.org/debian unstable/main i386 libngtcp2-16 i386 1.6.0-1 [154 kB] Get: 117 http://deb.debian.org/debian unstable/main i386 libngtcp2-crypto-gnutls8 i386 1.6.0-1 [20.2 kB] Get: 118 http://deb.debian.org/debian unstable/main i386 libpsl5t64 i386 0.21.2-1.1+b1 [57.7 kB] Get: 119 http://deb.debian.org/debian unstable/main i386 librtmp1 i386 2.4+20151223.gitfa8646d.1-2+b5 [62.4 kB] Get: 120 http://deb.debian.org/debian unstable/main i386 libssh2-1t64 i386 1.11.1-1 [256 kB] Get: 121 http://deb.debian.org/debian unstable/main i386 libcurl3t64-gnutls i386 8.11.0-1 [403 kB] Get: 122 http://deb.debian.org/debian unstable/main i386 libgpgme11t64 i386 1.24.0-2 [349 kB] Get: 123 http://deb.debian.org/debian unstable/main i386 libgpgmepp6t64 i386 1.24.0-2 [350 kB] Get: 124 http://deb.debian.org/debian unstable/main i386 libnspr4 i386 2:4.36-1 [119 kB] Get: 125 http://deb.debian.org/debian unstable/main i386 libnss3 i386 2:3.106-1 [1504 kB] Get: 126 http://deb.debian.org/debian unstable/main i386 libpoppler140 i386 24.08.0-3 [2022 kB] Get: 127 http://deb.debian.org/debian unstable/main i386 libpixman-1-0 i386 0.44.0-3 [246 kB] Get: 128 http://deb.debian.org/debian unstable/main i386 libxcb-render0 i386 1.17.0-2+b1 [116 kB] Get: 129 http://deb.debian.org/debian unstable/main i386 libxcb-shm0 i386 1.17.0-2+b1 [105 kB] Get: 130 http://deb.debian.org/debian unstable/main i386 libxext6 i386 2:1.3.4-1+b2 [52.6 kB] Get: 131 http://deb.debian.org/debian unstable/main i386 libxrender1 i386 1:0.9.10-1.1+b2 [28.9 kB] Get: 132 http://deb.debian.org/debian unstable/main i386 libcairo2 i386 1.18.2-2 [591 kB] Get: 133 http://deb.debian.org/debian unstable/main i386 poppler-utils i386 24.08.0-3 [220 kB] Get: 134 http://deb.debian.org/debian unstable/main i386 libkpathsea6 i386 2024.20240313.70630+ds-5 [160 kB] Get: 135 http://deb.debian.org/debian unstable/main i386 libptexenc1 i386 2024.20240313.70630+ds-5 [50.0 kB] Get: 136 http://deb.debian.org/debian unstable/main i386 libsynctex2 i386 2024.20240313.70630+ds-5 [65.6 kB] Get: 137 http://deb.debian.org/debian unstable/main i386 libtexlua53-5 i386 2024.20240313.70630+ds-5 [129 kB] Get: 138 http://deb.debian.org/debian unstable/main i386 t1utils i386 1.41-4 [62.3 kB] Get: 139 http://deb.debian.org/debian unstable/main i386 tex-common all 6.18 [32.5 kB] Get: 140 http://deb.debian.org/debian unstable/main i386 libgraphite2-3 i386 1.3.14-2+b1 [77.8 kB] Get: 141 http://deb.debian.org/debian unstable/main i386 libglib2.0-0t64 i386 2.82.2-3 [1571 kB] Get: 142 http://deb.debian.org/debian unstable/main i386 libharfbuzz0b i386 10.0.1-1 [503 kB] Get: 143 http://deb.debian.org/debian unstable/main i386 libmpfi0 i386 1.5.4+ds-4 [38.8 kB] Get: 144 http://deb.debian.org/debian unstable/main i386 libpotrace0 i386 1.16-2+b2 [24.5 kB] Get: 145 http://deb.debian.org/debian unstable/main i386 libteckit0 i386 2.5.12+ds1-1+b1 [285 kB] Get: 146 http://deb.debian.org/debian unstable/main i386 libxmu6 i386 2:1.1.3-3+b3 [60.9 kB] Get: 147 http://deb.debian.org/debian unstable/main i386 libxpm4 i386 1:3.5.17-1+b2 [58.3 kB] Get: 148 http://deb.debian.org/debian unstable/main i386 libxaw7 i386 2:1.0.16-1 [220 kB] Get: 149 http://deb.debian.org/debian unstable/main i386 libxi6 i386 2:1.8.2-1 [81.2 kB] Get: 150 http://deb.debian.org/debian unstable/main i386 libzzip-0-13t64 i386 0.13.72+dfsg.1-1.3 [58.0 kB] Get: 151 http://deb.debian.org/debian unstable/main i386 texlive-binaries i386 2024.20240313.70630+ds-5 [8368 kB] Get: 152 http://deb.debian.org/debian unstable/main i386 libpaper-utils i386 1.1.29+b2 [9304 B] Get: 153 http://deb.debian.org/debian unstable/main i386 xdg-utils all 1.1.3-4.1 [75.5 kB] Get: 154 http://deb.debian.org/debian unstable/main i386 texlive-base all 2024.20241115-1 [22.7 MB] Get: 155 http://deb.debian.org/debian unstable/main i386 texlive-fonts-recommended all 2024.20241115-1 [4991 kB] Get: 156 http://deb.debian.org/debian unstable/main i386 libapache-pom-java all 33-2 [5852 B] Get: 157 http://deb.debian.org/debian unstable/main i386 libcommons-parent-java all 56-1 [10.8 kB] Get: 158 http://deb.debian.org/debian unstable/main i386 libcommons-logging-java all 1.3.0-1 [68.6 kB] Get: 159 http://deb.debian.org/debian unstable/main i386 libfontbox-java all 1:1.8.16-5 [211 kB] Get: 160 http://deb.debian.org/debian unstable/main i386 libpdfbox-java all 1:1.8.16-5 [5527 kB] Get: 161 http://deb.debian.org/debian unstable/main i386 preview-latex-style all 13.2-1 [350 kB] Get: 162 http://deb.debian.org/debian unstable/main i386 texlive-latex-base all 2024.20241115-1 [1278 kB] Get: 163 http://deb.debian.org/debian unstable/main i386 texlive-latex-recommended all 2024.20241115-1 [8757 kB] Get: 164 http://deb.debian.org/debian unstable/main i386 texlive-pictures all 2024.20241115-1 [17.0 MB] Get: 165 http://deb.debian.org/debian unstable/main i386 texlive-latex-extra all 2024.20241115-1 [24.6 MB] Get: 166 http://deb.debian.org/debian unstable/main i386 latex2html all 2024.2-debian1-1 [2488 kB] Get: 167 http://deb.debian.org/debian unstable/main i386 libcminpack1 i386 1.3.6-5+b2 [37.7 kB] Get: 168 http://deb.debian.org/debian unstable/main i386 libcminpack-dev i386 1.3.6-5+b2 [12.0 kB] Get: 169 http://deb.debian.org/debian unstable/main i386 liberfa1 i386 2.0.1-1+b2 [130 kB] Get: 170 http://deb.debian.org/debian unstable/main i386 liberfa-dev i386 2.0.1-1+b2 [150 kB] Get: 171 http://deb.debian.org/debian unstable/main i386 libstarlink-pal0 i386 0.9.10-3 [45.8 kB] Get: 172 http://deb.debian.org/debian unstable/main i386 libstarlink-pal-dev i386 0.9.10-3 [58.0 kB] Get: 173 http://deb.debian.org/debian unstable/main i386 texlive all 2024.20241115-1 [18.6 kB] Get: 174 http://deb.debian.org/debian unstable/main i386 texlive-font-utils all 2024.20241115-1 [6980 kB] Get: 175 http://deb.debian.org/debian unstable/main i386 texlive-lang-greek all 2024.20241115-1 [79.2 MB] Get: 176 http://deb.debian.org/debian unstable/main i386 texlive-science all 2024.20241115-1 [3876 kB] Fetched 266 MB in 4s (59.2 MB/s) debconf: delaying package configuration, since apt-utils is not installed Selecting previously unselected package poppler-data. (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 ... 19952 files and directories currently installed.) Preparing to unpack .../poppler-data_0.4.12-1_all.deb ... Unpacking poppler-data (0.4.12-1) ... Selecting previously unselected package libpython3.12-minimal:i386. Preparing to unpack .../libpython3.12-minimal_3.12.7-3_i386.deb ... Unpacking libpython3.12-minimal:i386 (3.12.7-3) ... Selecting previously unselected package libexpat1:i386. Preparing to unpack .../libexpat1_2.6.4-1_i386.deb ... Unpacking libexpat1:i386 (2.6.4-1) ... Selecting previously unselected package python3.12-minimal. Preparing to unpack .../python3.12-minimal_3.12.7-3_i386.deb ... Unpacking python3.12-minimal (3.12.7-3) ... Setting up libpython3.12-minimal:i386 (3.12.7-3) ... Setting up libexpat1:i386 (2.6.4-1) ... Setting up python3.12-minimal (3.12.7-3) ... Selecting previously unselected package python3-minimal. (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 ... 20806 files and directories currently installed.) Preparing to unpack .../00-python3-minimal_3.12.7-1_i386.deb ... Unpacking python3-minimal (3.12.7-1) ... Selecting previously unselected package media-types. Preparing to unpack .../01-media-types_10.1.0_all.deb ... Unpacking media-types (10.1.0) ... Selecting previously unselected package netbase. Preparing to unpack .../02-netbase_6.4_all.deb ... Unpacking netbase (6.4) ... Selecting previously unselected package tzdata. Preparing to unpack .../03-tzdata_2024b-3_all.deb ... Unpacking tzdata (2024b-3) ... Selecting previously unselected package libkrb5support0:i386. Preparing to unpack .../04-libkrb5support0_1.21.3-3_i386.deb ... Unpacking libkrb5support0:i386 (1.21.3-3) ... Selecting previously unselected package libcom-err2:i386. Preparing to unpack .../05-libcom-err2_1.47.1-1+b1_i386.deb ... Unpacking libcom-err2:i386 (1.47.1-1+b1) ... Selecting previously unselected package libk5crypto3:i386. Preparing to unpack .../06-libk5crypto3_1.21.3-3_i386.deb ... Unpacking libk5crypto3:i386 (1.21.3-3) ... Selecting previously unselected package libkeyutils1:i386. Preparing to unpack .../07-libkeyutils1_1.6.3-4_i386.deb ... Unpacking libkeyutils1:i386 (1.6.3-4) ... Selecting previously unselected package libkrb5-3:i386. Preparing to unpack .../08-libkrb5-3_1.21.3-3_i386.deb ... Unpacking libkrb5-3:i386 (1.21.3-3) ... Selecting previously unselected package libgssapi-krb5-2:i386. Preparing to unpack .../09-libgssapi-krb5-2_1.21.3-3_i386.deb ... Unpacking libgssapi-krb5-2:i386 (1.21.3-3) ... Selecting previously unselected package libtirpc-common. Preparing to unpack .../10-libtirpc-common_1.3.4+ds-1.3_all.deb ... Unpacking libtirpc-common (1.3.4+ds-1.3) ... Selecting previously unselected package libtirpc3t64:i386. Preparing to unpack .../11-libtirpc3t64_1.3.4+ds-1.3+b1_i386.deb ... Adding 'diversion of /lib/i386-linux-gnu/libtirpc.so.3 to /lib/i386-linux-gnu/libtirpc.so.3.usr-is-merged by libtirpc3t64' Adding 'diversion of /lib/i386-linux-gnu/libtirpc.so.3.0.0 to /lib/i386-linux-gnu/libtirpc.so.3.0.0.usr-is-merged by libtirpc3t64' Unpacking libtirpc3t64:i386 (1.3.4+ds-1.3+b1) ... Selecting previously unselected package libnsl2:i386. Preparing to unpack .../12-libnsl2_1.3.0-3+b3_i386.deb ... Unpacking libnsl2:i386 (1.3.0-3+b3) ... Selecting previously unselected package readline-common. Preparing to unpack .../13-readline-common_8.2-5_all.deb ... Unpacking readline-common (8.2-5) ... Selecting previously unselected package libreadline8t64:i386. Preparing to unpack .../14-libreadline8t64_8.2-5_i386.deb ... Adding 'diversion of /lib/i386-linux-gnu/libhistory.so.8 to /lib/i386-linux-gnu/libhistory.so.8.usr-is-merged by libreadline8t64' Adding 'diversion of /lib/i386-linux-gnu/libhistory.so.8.2 to /lib/i386-linux-gnu/libhistory.so.8.2.usr-is-merged by libreadline8t64' Adding 'diversion of /lib/i386-linux-gnu/libreadline.so.8 to /lib/i386-linux-gnu/libreadline.so.8.usr-is-merged by libreadline8t64' Adding 'diversion of /lib/i386-linux-gnu/libreadline.so.8.2 to /lib/i386-linux-gnu/libreadline.so.8.2.usr-is-merged by libreadline8t64' Unpacking libreadline8t64:i386 (8.2-5) ... Selecting previously unselected package libpython3.12-stdlib:i386. Preparing to unpack .../15-libpython3.12-stdlib_3.12.7-3_i386.deb ... Unpacking libpython3.12-stdlib:i386 (3.12.7-3) ... Selecting previously unselected package python3.12. Preparing to unpack .../16-python3.12_3.12.7-3_i386.deb ... Unpacking python3.12 (3.12.7-3) ... Selecting previously unselected package libpython3-stdlib:i386. Preparing to unpack .../17-libpython3-stdlib_3.12.7-1_i386.deb ... Unpacking libpython3-stdlib:i386 (3.12.7-1) ... Setting up python3-minimal (3.12.7-1) ... Selecting previously unselected package python3. (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 ... 21868 files and directories currently installed.) Preparing to unpack .../000-python3_3.12.7-1_i386.deb ... Unpacking python3 (3.12.7-1) ... Selecting previously unselected package sensible-utils. Preparing to unpack .../001-sensible-utils_0.0.24_all.deb ... Unpacking sensible-utils (0.0.24) ... Selecting previously unselected package libmagic-mgc. Preparing to unpack .../002-libmagic-mgc_1%3a5.45-3+b1_i386.deb ... Unpacking libmagic-mgc (1:5.45-3+b1) ... Selecting previously unselected package libmagic1t64:i386. Preparing to unpack .../003-libmagic1t64_1%3a5.45-3+b1_i386.deb ... Unpacking libmagic1t64:i386 (1:5.45-3+b1) ... Selecting previously unselected package file. Preparing to unpack .../004-file_1%3a5.45-3+b1_i386.deb ... Unpacking file (1:5.45-3+b1) ... Selecting previously unselected package gettext-base. Preparing to unpack .../005-gettext-base_0.22.5-2_i386.deb ... Unpacking gettext-base (0.22.5-2) ... Selecting previously unselected package libuchardet0:i386. Preparing to unpack .../006-libuchardet0_0.0.8-1+b2_i386.deb ... Unpacking libuchardet0:i386 (0.0.8-1+b2) ... Selecting previously unselected package groff-base. Preparing to unpack .../007-groff-base_1.23.0-5_i386.deb ... Unpacking groff-base (1.23.0-5) ... Selecting previously unselected package bsdextrautils. Preparing to unpack .../008-bsdextrautils_2.40.2-11_i386.deb ... Unpacking bsdextrautils (2.40.2-11) ... Selecting previously unselected package libpipeline1:i386. Preparing to unpack .../009-libpipeline1_1.5.8-1_i386.deb ... Unpacking libpipeline1:i386 (1.5.8-1) ... Selecting previously unselected package man-db. Preparing to unpack .../010-man-db_2.13.0-1_i386.deb ... Unpacking man-db (2.13.0-1) ... Selecting previously unselected package ucf. Preparing to unpack .../011-ucf_3.0043+nmu1_all.deb ... Moving old data out of the way Unpacking ucf (3.0043+nmu1) ... Selecting previously unselected package m4. Preparing to unpack .../012-m4_1.4.19-4_i386.deb ... Unpacking m4 (1.4.19-4) ... Selecting previously unselected package autoconf. Preparing to unpack .../013-autoconf_2.72-3_all.deb ... Unpacking autoconf (2.72-3) ... Selecting previously unselected package autotools-dev. Preparing to unpack .../014-autotools-dev_20220109.1_all.deb ... Unpacking autotools-dev (20220109.1) ... Selecting previously unselected package automake. Preparing to unpack .../015-automake_1%3a1.16.5-1.3_all.deb ... Unpacking automake (1:1.16.5-1.3) ... Selecting previously unselected package autopoint. Preparing to unpack .../016-autopoint_0.22.5-2_all.deb ... Unpacking autopoint (0.22.5-2) ... Selecting previously unselected package libdebhelper-perl. Preparing to unpack .../017-libdebhelper-perl_13.20_all.deb ... Unpacking libdebhelper-perl (13.20) ... Selecting previously unselected package libtool. Preparing to unpack .../018-libtool_2.4.7-8_all.deb ... Unpacking libtool (2.4.7-8) ... Selecting previously unselected package dh-autoreconf. Preparing to unpack .../019-dh-autoreconf_20_all.deb ... Unpacking dh-autoreconf (20) ... Selecting previously unselected package libarchive-zip-perl. Preparing to unpack .../020-libarchive-zip-perl_1.68-1_all.deb ... Unpacking libarchive-zip-perl (1.68-1) ... Selecting previously unselected package libfile-stripnondeterminism-perl. Preparing to unpack .../021-libfile-stripnondeterminism-perl_1.14.0-1_all.deb ... Unpacking libfile-stripnondeterminism-perl (1.14.0-1) ... Selecting previously unselected package dh-strip-nondeterminism. Preparing to unpack .../022-dh-strip-nondeterminism_1.14.0-1_all.deb ... Unpacking dh-strip-nondeterminism (1.14.0-1) ... Selecting previously unselected package libelf1t64:i386. Preparing to unpack .../023-libelf1t64_0.192-4_i386.deb ... Unpacking libelf1t64:i386 (0.192-4) ... Selecting previously unselected package dwz. Preparing to unpack .../024-dwz_0.15-1+b1_i386.deb ... Unpacking dwz (0.15-1+b1) ... Selecting previously unselected package libicu72:i386. Preparing to unpack .../025-libicu72_72.1-5+b1_i386.deb ... Unpacking libicu72:i386 (72.1-5+b1) ... Selecting previously unselected package libxml2:i386. Preparing to unpack .../026-libxml2_2.12.7+dfsg+really2.9.14-0.2+b1_i386.deb ... Unpacking libxml2:i386 (2.12.7+dfsg+really2.9.14-0.2+b1) ... Selecting previously unselected package gettext. Preparing to unpack .../027-gettext_0.22.5-2_i386.deb ... Unpacking gettext (0.22.5-2) ... Selecting previously unselected package intltool-debian. Preparing to unpack .../028-intltool-debian_0.35.0+20060710.6_all.deb ... Unpacking intltool-debian (0.35.0+20060710.6) ... Selecting previously unselected package po-debconf. Preparing to unpack .../029-po-debconf_1.0.21+nmu1_all.deb ... Unpacking po-debconf (1.0.21+nmu1) ... Selecting previously unselected package debhelper. Preparing to unpack .../030-debhelper_13.20_all.deb ... Unpacking debhelper (13.20) ... Selecting previously unselected package libassuan9:i386. Preparing to unpack .../031-libassuan9_3.0.1-2_i386.deb ... Unpacking libassuan9:i386 (3.0.1-2) ... Selecting previously unselected package gpgconf. Preparing to unpack .../032-gpgconf_2.2.45-2_i386.deb ... Unpacking gpgconf (2.2.45-2) ... Selecting previously unselected package libksba8:i386. Preparing to unpack .../033-libksba8_1.6.7-2+b1_i386.deb ... Unpacking libksba8:i386 (1.6.7-2+b1) ... Selecting previously unselected package libsasl2-modules-db:i386. Preparing to unpack .../034-libsasl2-modules-db_2.1.28+dfsg1-8_i386.deb ... Unpacking libsasl2-modules-db:i386 (2.1.28+dfsg1-8) ... Selecting previously unselected package libsasl2-2:i386. Preparing to unpack .../035-libsasl2-2_2.1.28+dfsg1-8_i386.deb ... Unpacking libsasl2-2:i386 (2.1.28+dfsg1-8) ... Selecting previously unselected package libldap-2.5-0:i386. Preparing to unpack .../036-libldap-2.5-0_2.5.18+dfsg-3+b1_i386.deb ... Unpacking libldap-2.5-0:i386 (2.5.18+dfsg-3+b1) ... Selecting previously unselected package libnpth0t64:i386. Preparing to unpack .../037-libnpth0t64_1.6-3.1+b1_i386.deb ... Unpacking libnpth0t64:i386 (1.6-3.1+b1) ... Selecting previously unselected package dirmngr. Preparing to unpack .../038-dirmngr_2.2.45-2_i386.deb ... Unpacking dirmngr (2.2.45-2) ... Selecting previously unselected package libfontenc1:i386. Preparing to unpack .../039-libfontenc1_1%3a1.1.8-1+b1_i386.deb ... Unpacking libfontenc1:i386 (1:1.1.8-1+b1) ... Selecting previously unselected package libbrotli1:i386. Preparing to unpack .../040-libbrotli1_1.1.0-2+b6_i386.deb ... Unpacking libbrotli1:i386 (1.1.0-2+b6) ... Selecting previously unselected package libpng16-16t64:i386. Preparing to unpack .../041-libpng16-16t64_1.6.44-2_i386.deb ... Unpacking libpng16-16t64:i386 (1.6.44-2) ... Selecting previously unselected package libfreetype6:i386. Preparing to unpack .../042-libfreetype6_2.13.3+dfsg-1_i386.deb ... Unpacking libfreetype6:i386 (2.13.3+dfsg-1) ... Selecting previously unselected package x11-common. Preparing to unpack .../043-x11-common_1%3a7.7+23.1_all.deb ... Unpacking x11-common (1:7.7+23.1) ... Selecting previously unselected package xfonts-encodings. Preparing to unpack .../044-xfonts-encodings_1%3a1.0.4-2.2_all.deb ... Unpacking xfonts-encodings (1:1.0.4-2.2) ... Selecting previously unselected package xfonts-utils. Preparing to unpack .../045-xfonts-utils_1%3a7.7+7_i386.deb ... Unpacking xfonts-utils (1:7.7+7) ... Selecting previously unselected package fonts-urw-base35. Preparing to unpack .../046-fonts-urw-base35_20200910-8_all.deb ... Unpacking fonts-urw-base35 (20200910-8) ... Selecting previously unselected package fontconfig-config. Preparing to unpack .../047-fontconfig-config_2.15.0-1.1+b1_i386.deb ... Unpacking fontconfig-config (2.15.0-1.1+b1) ... Selecting previously unselected package fonts-gfs-baskerville. Preparing to unpack .../048-fonts-gfs-baskerville_1.1-6_all.deb ... Unpacking fonts-gfs-baskerville (1.1-6) ... Selecting previously unselected package fonts-gfs-porson. Preparing to unpack .../049-fonts-gfs-porson_1.1-7_all.deb ... Unpacking fonts-gfs-porson (1.1-7) ... Selecting previously unselected package fonts-lmodern. Preparing to unpack .../050-fonts-lmodern_2.005-1_all.deb ... Unpacking fonts-lmodern (2.005-1) ... Selecting previously unselected package libgs-common. Preparing to unpack .../051-libgs-common_10.04.0~dfsg-1_all.deb ... Unpacking libgs-common (10.04.0~dfsg-1) ... Selecting previously unselected package libgs10-common. Preparing to unpack .../052-libgs10-common_10.04.0~dfsg-1_all.deb ... Unpacking libgs10-common (10.04.0~dfsg-1) ... Selecting previously unselected package libavahi-common-data:i386. Preparing to unpack .../053-libavahi-common-data_0.8-13+b3_i386.deb ... Unpacking libavahi-common-data:i386 (0.8-13+b3) ... Selecting previously unselected package libavahi-common3:i386. Preparing to unpack .../054-libavahi-common3_0.8-13+b3_i386.deb ... Unpacking libavahi-common3:i386 (0.8-13+b3) ... Selecting previously unselected package libdbus-1-3:i386. Preparing to unpack .../055-libdbus-1-3_1.14.10-6_i386.deb ... Unpacking libdbus-1-3:i386 (1.14.10-6) ... Selecting previously unselected package libavahi-client3:i386. Preparing to unpack .../056-libavahi-client3_0.8-13+b3_i386.deb ... Unpacking libavahi-client3:i386 (0.8-13+b3) ... Selecting previously unselected package libcups2t64:i386. Preparing to unpack .../057-libcups2t64_2.4.10-2_i386.deb ... Unpacking libcups2t64:i386 (2.4.10-2) ... Selecting previously unselected package libfontconfig1:i386. Preparing to unpack .../058-libfontconfig1_2.15.0-1.1+b1_i386.deb ... Unpacking libfontconfig1:i386 (2.15.0-1.1+b1) ... Selecting previously unselected package libidn12:i386. Preparing to unpack .../059-libidn12_1.42-2+b1_i386.deb ... Unpacking libidn12:i386 (1.42-2+b1) ... Selecting previously unselected package libijs-0.35:i386. Preparing to unpack .../060-libijs-0.35_0.35-15.1+b2_i386.deb ... Unpacking libijs-0.35:i386 (0.35-15.1+b2) ... Selecting previously unselected package libjbig2dec0:i386. Preparing to unpack .../061-libjbig2dec0_0.20-1+b3_i386.deb ... Unpacking libjbig2dec0:i386 (0.20-1+b3) ... Selecting previously unselected package libjpeg62-turbo:i386. Preparing to unpack .../062-libjpeg62-turbo_1%3a2.1.5-3+b1_i386.deb ... Unpacking libjpeg62-turbo:i386 (1:2.1.5-3+b1) ... Selecting previously unselected package liblcms2-2:i386. Preparing to unpack .../063-liblcms2-2_2.16-2_i386.deb ... Unpacking liblcms2-2:i386 (2.16-2) ... Selecting previously unselected package libopenjp2-7:i386. Preparing to unpack .../064-libopenjp2-7_2.5.0-2+b4_i386.deb ... Unpacking libopenjp2-7:i386 (2.5.0-2+b4) ... Selecting previously unselected package libpaper1:i386. Preparing to unpack .../065-libpaper1_1.1.29+b2_i386.deb ... Unpacking libpaper1:i386 (1.1.29+b2) ... Selecting previously unselected package libdeflate0:i386. Preparing to unpack .../066-libdeflate0_1.22-1_i386.deb ... Unpacking libdeflate0:i386 (1.22-1) ... Selecting previously unselected package libjbig0:i386. Preparing to unpack .../067-libjbig0_2.1-6.1+b2_i386.deb ... Unpacking libjbig0:i386 (2.1-6.1+b2) ... Selecting previously unselected package liblerc4:i386. Preparing to unpack .../068-liblerc4_4.0.0+ds-5_i386.deb ... Unpacking liblerc4:i386 (4.0.0+ds-5) ... Selecting previously unselected package libsharpyuv0:i386. Preparing to unpack .../069-libsharpyuv0_1.4.0-0.1+b1_i386.deb ... Unpacking libsharpyuv0:i386 (1.4.0-0.1+b1) ... Selecting previously unselected package libwebp7:i386. Preparing to unpack .../070-libwebp7_1.4.0-0.1+b1_i386.deb ... Unpacking libwebp7:i386 (1.4.0-0.1+b1) ... Selecting previously unselected package libtiff6:i386. Preparing to unpack .../071-libtiff6_4.5.1+git230720-5_i386.deb ... Unpacking libtiff6:i386 (4.5.1+git230720-5) ... Selecting previously unselected package libxau6:i386. Preparing to unpack .../072-libxau6_1%3a1.0.11-1_i386.deb ... Unpacking libxau6:i386 (1:1.0.11-1) ... Selecting previously unselected package libxdmcp6:i386. Preparing to unpack .../073-libxdmcp6_1%3a1.1.5-1_i386.deb ... Unpacking libxdmcp6:i386 (1:1.1.5-1) ... Selecting previously unselected package libxcb1:i386. Preparing to unpack .../074-libxcb1_1.17.0-2+b1_i386.deb ... Unpacking libxcb1:i386 (1.17.0-2+b1) ... Selecting previously unselected package libx11-data. Preparing to unpack .../075-libx11-data_2%3a1.8.10-2_all.deb ... Unpacking libx11-data (2:1.8.10-2) ... Selecting previously unselected package libx11-6:i386. Preparing to unpack .../076-libx11-6_2%3a1.8.10-2_i386.deb ... Unpacking libx11-6:i386 (2:1.8.10-2) ... Selecting previously unselected package libice6:i386. Preparing to unpack .../077-libice6_2%3a1.1.1-1_i386.deb ... Unpacking libice6:i386 (2:1.1.1-1) ... Selecting previously unselected package libsm6:i386. Preparing to unpack .../078-libsm6_2%3a1.2.4-1_i386.deb ... Unpacking libsm6:i386 (2:1.2.4-1) ... Selecting previously unselected package libxt6t64:i386. Preparing to unpack .../079-libxt6t64_1%3a1.2.1-1.2+b1_i386.deb ... Unpacking libxt6t64:i386 (1:1.2.1-1.2+b1) ... Selecting previously unselected package libgs10:i386. Preparing to unpack .../080-libgs10_10.04.0~dfsg-1_i386.deb ... Unpacking libgs10:i386 (10.04.0~dfsg-1) ... Selecting previously unselected package ghostscript. Preparing to unpack .../081-ghostscript_10.04.0~dfsg-1_i386.deb ... Unpacking ghostscript (10.04.0~dfsg-1) ... Selecting previously unselected package gnupg-l10n. Preparing to unpack .../082-gnupg-l10n_2.2.45-2_all.deb ... Unpacking gnupg-l10n (2.2.45-2) ... Selecting previously unselected package gpg. Preparing to unpack .../083-gpg_2.2.45-2_i386.deb ... Unpacking gpg (2.2.45-2) ... Selecting previously unselected package pinentry-curses. Preparing to unpack .../084-pinentry-curses_1.2.1-4+b1_i386.deb ... Unpacking pinentry-curses (1.2.1-4+b1) ... Selecting previously unselected package gpg-agent. Preparing to unpack .../085-gpg-agent_2.2.45-2_i386.deb ... Unpacking gpg-agent (2.2.45-2) ... Selecting previously unselected package gpgsm. Preparing to unpack .../086-gpgsm_2.2.45-2_i386.deb ... Unpacking gpgsm (2.2.45-2) ... Selecting previously unselected package gnupg. Preparing to unpack .../087-gnupg_2.2.45-2_all.deb ... Unpacking gnupg (2.2.45-2) ... Selecting previously unselected package libnetpbm11t64:i386. Preparing to unpack .../088-libnetpbm11t64_2%3a11.08.01-1+b1_i386.deb ... Unpacking libnetpbm11t64:i386 (2:11.08.01-1+b1) ... Selecting previously unselected package netpbm. Preparing to unpack .../089-netpbm_2%3a11.08.01-1+b1_i386.deb ... Unpacking netpbm (2:11.08.01-1+b1) ... Selecting previously unselected package perl-doc. Preparing to unpack .../090-perl-doc_5.40.0-7_all.deb ... Adding 'diversion of /usr/bin/perldoc to /usr/bin/perldoc.stub by perl-doc' Unpacking perl-doc (5.40.0-7) ... Selecting previously unselected package libnghttp2-14:i386. Preparing to unpack .../091-libnghttp2-14_1.64.0-1_i386.deb ... Unpacking libnghttp2-14:i386 (1.64.0-1) ... Selecting previously unselected package libnghttp3-9:i386. Preparing to unpack .../092-libnghttp3-9_1.4.0-1+b1_i386.deb ... Unpacking libnghttp3-9:i386 (1.4.0-1+b1) ... Selecting previously unselected package libngtcp2-16:i386. Preparing to unpack .../093-libngtcp2-16_1.6.0-1_i386.deb ... Unpacking libngtcp2-16:i386 (1.6.0-1) ... Selecting previously unselected package libngtcp2-crypto-gnutls8:i386. Preparing to unpack .../094-libngtcp2-crypto-gnutls8_1.6.0-1_i386.deb ... Unpacking libngtcp2-crypto-gnutls8:i386 (1.6.0-1) ... Selecting previously unselected package libpsl5t64:i386. Preparing to unpack .../095-libpsl5t64_0.21.2-1.1+b1_i386.deb ... Unpacking libpsl5t64:i386 (0.21.2-1.1+b1) ... Selecting previously unselected package librtmp1:i386. Preparing to unpack .../096-librtmp1_2.4+20151223.gitfa8646d.1-2+b5_i386.deb ... Unpacking librtmp1:i386 (2.4+20151223.gitfa8646d.1-2+b5) ... Selecting previously unselected package libssh2-1t64:i386. Preparing to unpack .../097-libssh2-1t64_1.11.1-1_i386.deb ... Unpacking libssh2-1t64:i386 (1.11.1-1) ... Selecting previously unselected package libcurl3t64-gnutls:i386. Preparing to unpack .../098-libcurl3t64-gnutls_8.11.0-1_i386.deb ... Unpacking libcurl3t64-gnutls:i386 (8.11.0-1) ... Selecting previously unselected package libgpgme11t64:i386. Preparing to unpack .../099-libgpgme11t64_1.24.0-2_i386.deb ... Unpacking libgpgme11t64:i386 (1.24.0-2) ... Selecting previously unselected package libgpgmepp6t64:i386. Preparing to unpack .../100-libgpgmepp6t64_1.24.0-2_i386.deb ... Unpacking libgpgmepp6t64:i386 (1.24.0-2) ... Selecting previously unselected package libnspr4:i386. Preparing to unpack .../101-libnspr4_2%3a4.36-1_i386.deb ... Unpacking libnspr4:i386 (2:4.36-1) ... Selecting previously unselected package libnss3:i386. Preparing to unpack .../102-libnss3_2%3a3.106-1_i386.deb ... Unpacking libnss3:i386 (2:3.106-1) ... Selecting previously unselected package libpoppler140:i386. Preparing to unpack .../103-libpoppler140_24.08.0-3_i386.deb ... Unpacking libpoppler140:i386 (24.08.0-3) ... Selecting previously unselected package libpixman-1-0:i386. Preparing to unpack .../104-libpixman-1-0_0.44.0-3_i386.deb ... Unpacking libpixman-1-0:i386 (0.44.0-3) ... Selecting previously unselected package libxcb-render0:i386. Preparing to unpack .../105-libxcb-render0_1.17.0-2+b1_i386.deb ... Unpacking libxcb-render0:i386 (1.17.0-2+b1) ... Selecting previously unselected package libxcb-shm0:i386. Preparing to unpack .../106-libxcb-shm0_1.17.0-2+b1_i386.deb ... Unpacking libxcb-shm0:i386 (1.17.0-2+b1) ... Selecting previously unselected package libxext6:i386. Preparing to unpack .../107-libxext6_2%3a1.3.4-1+b2_i386.deb ... Unpacking libxext6:i386 (2:1.3.4-1+b2) ... Selecting previously unselected package libxrender1:i386. Preparing to unpack .../108-libxrender1_1%3a0.9.10-1.1+b2_i386.deb ... Unpacking libxrender1:i386 (1:0.9.10-1.1+b2) ... Selecting previously unselected package libcairo2:i386. Preparing to unpack .../109-libcairo2_1.18.2-2_i386.deb ... Unpacking libcairo2:i386 (1.18.2-2) ... Selecting previously unselected package poppler-utils. Preparing to unpack .../110-poppler-utils_24.08.0-3_i386.deb ... Unpacking poppler-utils (24.08.0-3) ... Selecting previously unselected package libkpathsea6:i386. Preparing to unpack .../111-libkpathsea6_2024.20240313.70630+ds-5_i386.deb ... Unpacking libkpathsea6:i386 (2024.20240313.70630+ds-5) ... Selecting previously unselected package libptexenc1:i386. Preparing to unpack .../112-libptexenc1_2024.20240313.70630+ds-5_i386.deb ... Unpacking libptexenc1:i386 (2024.20240313.70630+ds-5) ... Selecting previously unselected package libsynctex2:i386. Preparing to unpack .../113-libsynctex2_2024.20240313.70630+ds-5_i386.deb ... Unpacking libsynctex2:i386 (2024.20240313.70630+ds-5) ... Selecting previously unselected package libtexlua53-5:i386. Preparing to unpack .../114-libtexlua53-5_2024.20240313.70630+ds-5_i386.deb ... Unpacking libtexlua53-5:i386 (2024.20240313.70630+ds-5) ... Selecting previously unselected package t1utils. Preparing to unpack .../115-t1utils_1.41-4_i386.deb ... Unpacking t1utils (1.41-4) ... Selecting previously unselected package tex-common. Preparing to unpack .../116-tex-common_6.18_all.deb ... Unpacking tex-common (6.18) ... Selecting previously unselected package libgraphite2-3:i386. Preparing to unpack .../117-libgraphite2-3_1.3.14-2+b1_i386.deb ... Unpacking libgraphite2-3:i386 (1.3.14-2+b1) ... Selecting previously unselected package libglib2.0-0t64:i386. Preparing to unpack .../118-libglib2.0-0t64_2.82.2-3_i386.deb ... Unpacking libglib2.0-0t64:i386 (2.82.2-3) ... Selecting previously unselected package libharfbuzz0b:i386. Preparing to unpack .../119-libharfbuzz0b_10.0.1-1_i386.deb ... Unpacking libharfbuzz0b:i386 (10.0.1-1) ... Selecting previously unselected package libmpfi0:i386. Preparing to unpack .../120-libmpfi0_1.5.4+ds-4_i386.deb ... Unpacking libmpfi0:i386 (1.5.4+ds-4) ... Selecting previously unselected package libpotrace0:i386. Preparing to unpack .../121-libpotrace0_1.16-2+b2_i386.deb ... Unpacking libpotrace0:i386 (1.16-2+b2) ... Selecting previously unselected package libteckit0:i386. Preparing to unpack .../122-libteckit0_2.5.12+ds1-1+b1_i386.deb ... Unpacking libteckit0:i386 (2.5.12+ds1-1+b1) ... Selecting previously unselected package libxmu6:i386. Preparing to unpack .../123-libxmu6_2%3a1.1.3-3+b3_i386.deb ... Unpacking libxmu6:i386 (2:1.1.3-3+b3) ... Selecting previously unselected package libxpm4:i386. Preparing to unpack .../124-libxpm4_1%3a3.5.17-1+b2_i386.deb ... Unpacking libxpm4:i386 (1:3.5.17-1+b2) ... Selecting previously unselected package libxaw7:i386. Preparing to unpack .../125-libxaw7_2%3a1.0.16-1_i386.deb ... Unpacking libxaw7:i386 (2:1.0.16-1) ... Selecting previously unselected package libxi6:i386. Preparing to unpack .../126-libxi6_2%3a1.8.2-1_i386.deb ... Unpacking libxi6:i386 (2:1.8.2-1) ... Selecting previously unselected package libzzip-0-13t64:i386. Preparing to unpack .../127-libzzip-0-13t64_0.13.72+dfsg.1-1.3_i386.deb ... Unpacking libzzip-0-13t64:i386 (0.13.72+dfsg.1-1.3) ... Selecting previously unselected package texlive-binaries. Preparing to unpack .../128-texlive-binaries_2024.20240313.70630+ds-5_i386.deb ... Unpacking texlive-binaries (2024.20240313.70630+ds-5) ... Selecting previously unselected package libpaper-utils. Preparing to unpack .../129-libpaper-utils_1.1.29+b2_i386.deb ... Unpacking libpaper-utils (1.1.29+b2) ... Selecting previously unselected package xdg-utils. Preparing to unpack .../130-xdg-utils_1.1.3-4.1_all.deb ... Unpacking xdg-utils (1.1.3-4.1) ... Selecting previously unselected package texlive-base. Preparing to unpack .../131-texlive-base_2024.20241115-1_all.deb ... Unpacking texlive-base (2024.20241115-1) ... Selecting previously unselected package texlive-fonts-recommended. Preparing to unpack .../132-texlive-fonts-recommended_2024.20241115-1_all.deb ... Unpacking texlive-fonts-recommended (2024.20241115-1) ... Selecting previously unselected package libapache-pom-java. Preparing to unpack .../133-libapache-pom-java_33-2_all.deb ... Unpacking libapache-pom-java (33-2) ... Selecting previously unselected package libcommons-parent-java. Preparing to unpack .../134-libcommons-parent-java_56-1_all.deb ... Unpacking libcommons-parent-java (56-1) ... Selecting previously unselected package libcommons-logging-java. Preparing to unpack .../135-libcommons-logging-java_1.3.0-1_all.deb ... Unpacking libcommons-logging-java (1.3.0-1) ... Selecting previously unselected package libfontbox-java. Preparing to unpack .../136-libfontbox-java_1%3a1.8.16-5_all.deb ... Unpacking libfontbox-java (1:1.8.16-5) ... Selecting previously unselected package libpdfbox-java. Preparing to unpack .../137-libpdfbox-java_1%3a1.8.16-5_all.deb ... Unpacking libpdfbox-java (1:1.8.16-5) ... Selecting previously unselected package preview-latex-style. Preparing to unpack .../138-preview-latex-style_13.2-1_all.deb ... Unpacking preview-latex-style (13.2-1) ... Selecting previously unselected package texlive-latex-base. Preparing to unpack .../139-texlive-latex-base_2024.20241115-1_all.deb ... Unpacking texlive-latex-base (2024.20241115-1) ... Selecting previously unselected package texlive-latex-recommended. Preparing to unpack .../140-texlive-latex-recommended_2024.20241115-1_all.deb ... Unpacking texlive-latex-recommended (2024.20241115-1) ... Selecting previously unselected package texlive-pictures. Preparing to unpack .../141-texlive-pictures_2024.20241115-1_all.deb ... Unpacking texlive-pictures (2024.20241115-1) ... Selecting previously unselected package texlive-latex-extra. Preparing to unpack .../142-texlive-latex-extra_2024.20241115-1_all.deb ... Unpacking texlive-latex-extra (2024.20241115-1) ... Selecting previously unselected package latex2html. Preparing to unpack .../143-latex2html_2024.2-debian1-1_all.deb ... Unpacking latex2html (2024.2-debian1-1) ... Selecting previously unselected package libcminpack1:i386. Preparing to unpack .../144-libcminpack1_1.3.6-5+b2_i386.deb ... Unpacking libcminpack1:i386 (1.3.6-5+b2) ... Selecting previously unselected package libcminpack-dev:i386. Preparing to unpack .../145-libcminpack-dev_1.3.6-5+b2_i386.deb ... Unpacking libcminpack-dev:i386 (1.3.6-5+b2) ... Selecting previously unselected package liberfa1:i386. Preparing to unpack .../146-liberfa1_2.0.1-1+b2_i386.deb ... Unpacking liberfa1:i386 (2.0.1-1+b2) ... Selecting previously unselected package liberfa-dev:i386. Preparing to unpack .../147-liberfa-dev_2.0.1-1+b2_i386.deb ... Unpacking liberfa-dev:i386 (2.0.1-1+b2) ... Selecting previously unselected package libstarlink-pal0:i386. Preparing to unpack .../148-libstarlink-pal0_0.9.10-3_i386.deb ... Unpacking libstarlink-pal0:i386 (0.9.10-3) ... Selecting previously unselected package libstarlink-pal-dev:i386. Preparing to unpack .../149-libstarlink-pal-dev_0.9.10-3_i386.deb ... Unpacking libstarlink-pal-dev:i386 (0.9.10-3) ... Selecting previously unselected package texlive. Preparing to unpack .../150-texlive_2024.20241115-1_all.deb ... Unpacking texlive (2024.20241115-1) ... Selecting previously unselected package texlive-font-utils. Preparing to unpack .../151-texlive-font-utils_2024.20241115-1_all.deb ... Unpacking texlive-font-utils (2024.20241115-1) ... Selecting previously unselected package texlive-lang-greek. Preparing to unpack .../152-texlive-lang-greek_2024.20241115-1_all.deb ... Unpacking texlive-lang-greek (2024.20241115-1) ... Selecting previously unselected package texlive-science. Preparing to unpack .../153-texlive-science_2024.20241115-1_all.deb ... Unpacking texlive-science (2024.20241115-1) ... Setting up libksba8:i386 (1.6.7-2+b1) ... Setting up media-types (10.1.0) ... Setting up libpipeline1:i386 (1.5.8-1) ... Setting up liberfa1:i386 (2.0.1-1+b2) ... Setting up libgraphite2-3:i386 (1.3.14-2+b1) ... Setting up liblcms2-2:i386 (2.16-2) ... Setting up libpixman-1-0:i386 (0.44.0-3) ... Setting up libsharpyuv0:i386 (1.4.0-0.1+b1) ... Setting up libxau6:i386 (1:1.0.11-1) ... Setting up libxdmcp6:i386 (1:1.1.5-1) ... Setting up libnpth0t64:i386 (1.6-3.1+b1) ... Setting up libkeyutils1:i386 (1.6.3-4) ... Setting up libxcb1:i386 (1.17.0-2+b1) ... Setting up libicu72:i386 (72.1-5+b1) ... Setting up liblerc4:i386 (4.0.0+ds-5) ... Setting up bsdextrautils (2.40.2-11) ... Setting up fonts-gfs-porson (1.1-7) ... Setting up libmagic-mgc (1:5.45-3+b1) ... Setting up libxcb-render0:i386 (1.17.0-2+b1) ... Setting up libarchive-zip-perl (1.68-1) ... Setting up libtirpc-common (1.3.4+ds-1.3) ... Setting up libijs-0.35:i386 (0.35-15.1+b2) ... Setting up libdebhelper-perl (13.20) ... Setting up libgs-common (10.04.0~dfsg-1) ... Setting up libbrotli1:i386 (1.1.0-2+b6) ... Setting up liberfa-dev:i386 (2.0.1-1+b2) ... Setting up libfontbox-java (1:1.8.16-5) ... Setting up libmagic1t64:i386 (1:5.45-3+b1) ... Setting up x11-common (1:7.7+23.1) ... invoke-rc.d: could not determine current runlevel Setting up X socket directories... /tmp/.X11-unix /tmp/.ICE-unix. Setting up libpsl5t64:i386 (0.21.2-1.1+b1) ... Setting up libnghttp2-14:i386 (1.64.0-1) ... Setting up libdeflate0:i386 (1.22-1) ... Setting up perl-doc (5.40.0-7) ... Setting up gettext-base (0.22.5-2) ... Setting up m4 (1.4.19-4) ... Setting up libcminpack1:i386 (1.3.6-5+b2) ... Setting up libxcb-shm0:i386 (1.17.0-2+b1) ... Setting up libcom-err2:i386 (1.47.1-1+b1) ... Setting up file (1:5.45-3+b1) ... Setting up libjbig0:i386 (2.1-6.1+b2) ... Setting up libnetpbm11t64:i386 (2:11.08.01-1+b1) ... Setting up libelf1t64:i386 (0.192-4) ... Setting up poppler-data (0.4.12-1) ... Setting up libkrb5support0:i386 (1.21.3-3) ... Setting up libsasl2-modules-db:i386 (2.1.28+dfsg1-8) ... Setting up tzdata (2024b-3) ... Current default time zone: 'Etc/UTC' Local time is now: Wed Nov 20 13:19:44 UTC 2024. Universal Time is now: Wed Nov 20 13:19:44 UTC 2024. Run 'dpkg-reconfigure tzdata' if you wish to change it. Setting up libfontenc1:i386 (1:1.1.8-1+b1) ... Setting up autotools-dev (20220109.1) ... Setting up libglib2.0-0t64:i386 (2.82.2-3) ... No schema files found: doing nothing. Setting up libjpeg62-turbo:i386 (1:2.1.5-3+b1) ... Setting up libzzip-0-13t64:i386 (0.13.72+dfsg.1-1.3) ... Setting up libx11-data (2:1.8.10-2) ... Setting up libnspr4:i386 (2:4.36-1) ... Setting up gnupg-l10n (2.2.45-2) ... Setting up libjbig2dec0:i386 (0.20-1+b3) ... Setting up librtmp1:i386 (2.4+20151223.gitfa8646d.1-2+b5) ... Setting up libteckit0:i386 (2.5.12+ds1-1+b1) ... Setting up libapache-pom-java (33-2) ... Setting up libavahi-common-data:i386 (0.8-13+b3) ... Setting up libdbus-1-3:i386 (1.14.10-6) ... Setting up xfonts-encodings (1:1.0.4-2.2) ... Setting up t1utils (1.41-4) ... Setting up libtexlua53-5:i386 (2024.20240313.70630+ds-5) ... Setting up libpng16-16t64:i386 (1.6.44-2) ... Setting up libstarlink-pal0:i386 (0.9.10-3) ... Setting up libidn12:i386 (1.42-2+b1) ... Setting up autopoint (0.22.5-2) ... Setting up libmpfi0:i386 (1.5.4+ds-4) ... Setting up libk5crypto3:i386 (1.21.3-3) ... Setting up libkpathsea6:i386 (2024.20240313.70630+ds-5) ... Setting up libsasl2-2:i386 (2.1.28+dfsg1-8) ... Setting up autoconf (2.72-3) ... Setting up libnghttp3-9:i386 (1.4.0-1+b1) ... Setting up libwebp7:i386 (1.4.0-0.1+b1) ... Setting up dwz (0.15-1+b1) ... Setting up fonts-gfs-baskerville (1.1-6) ... Setting up sensible-utils (0.0.24) ... Setting up libtiff6:i386 (4.5.1+git230720-5) ... Setting up libuchardet0:i386 (0.0.8-1+b2) ... Setting up libassuan9:i386 (3.0.1-2) ... Setting up fonts-lmodern (2.005-1) ... Setting up libopenjp2-7:i386 (2.5.0-2+b4) ... Setting up libx11-6:i386 (2:1.8.10-2) ... Setting up netbase (6.4) ... Setting up libngtcp2-16:i386 (1.6.0-1) ... Setting up libkrb5-3:i386 (1.21.3-3) ... Setting up libssh2-1t64:i386 (1.11.1-1) ... Setting up readline-common (8.2-5) ... Setting up libxml2:i386 (2.12.7+dfsg+really2.9.14-0.2+b1) ... Setting up xdg-utils (1.1.3-4.1) ... update-alternatives: using /usr/bin/xdg-open to provide /usr/bin/open (open) in auto mode Setting up libngtcp2-crypto-gnutls8:i386 (1.6.0-1) ... Setting up libsynctex2:i386 (2024.20240313.70630+ds-5) ... Setting up libpotrace0:i386 (1.16-2+b2) ... Setting up automake (1:1.16.5-1.3) ... update-alternatives: using /usr/bin/automake-1.16 to provide /usr/bin/automake (automake) in auto mode Setting up pinentry-curses (1.2.1-4+b1) ... Setting up libfile-stripnondeterminism-perl (1.14.0-1) ... Setting up libice6:i386 (2:1.1.1-1) ... Setting up gettext (0.22.5-2) ... Setting up libcminpack-dev:i386 (1.3.6-5+b2) ... Setting up libpdfbox-java (1:1.8.16-5) ... Setting up libxpm4:i386 (1:3.5.17-1+b2) ... Setting up libxrender1:i386 (1:0.9.10-1.1+b2) ... Setting up libtool (2.4.7-8) ... Setting up libcommons-parent-java (56-1) ... Setting up libavahi-common3:i386 (0.8-13+b3) ... Setting up libcommons-logging-java (1.3.0-1) ... Setting up libxext6:i386 (2:1.3.4-1+b2) ... Setting up libnss3:i386 (2:3.106-1) ... Setting up libstarlink-pal-dev:i386 (0.9.10-3) ... Setting up libldap-2.5-0:i386 (2.5.18+dfsg-3+b1) ... Setting up intltool-debian (0.35.0+20060710.6) ... Setting up dh-autoreconf (20) ... Setting up libptexenc1:i386 (2024.20240313.70630+ds-5) ... Setting up libfreetype6:i386 (2.13.3+dfsg-1) ... Setting up libgssapi-krb5-2:i386 (1.21.3-3) ... Setting up ucf (3.0043+nmu1) ... Setting up netpbm (2:11.08.01-1+b1) ... Setting up libreadline8t64:i386 (8.2-5) ... Setting up dh-strip-nondeterminism (1.14.0-1) ... Setting up groff-base (1.23.0-5) ... Setting up gpgconf (2.2.45-2) ... Setting up libharfbuzz0b:i386 (10.0.1-1) ... Setting up libsm6:i386 (2:1.2.4-1) ... Setting up libavahi-client3:i386 (0.8-13+b3) ... Setting up gpg (2.2.45-2) ... Setting up libpaper1:i386 (1.1.29+b2) ... Creating config file /etc/papersize with new version Setting up gpg-agent (2.2.45-2) ... Setting up libxi6:i386 (2:1.8.2-1) ... Setting up libtirpc3t64:i386 (1.3.4+ds-1.3+b1) ... Setting up po-debconf (1.0.21+nmu1) ... Setting up gpgsm (2.2.45-2) ... Setting up libcurl3t64-gnutls:i386 (8.11.0-1) ... Setting up libpaper-utils (1.1.29+b2) ... Setting up xfonts-utils (1:7.7+7) ... Setting up man-db (2.13.0-1) ... Not building database; man-db/auto-update is not 'true'. Setting up tex-common (6.18) ... update-language: texlive-base not installed and configured, doing nothing! Setting up dirmngr (2.2.45-2) ... Setting up libxt6t64:i386 (1:1.2.1-1.2+b1) ... Setting up libnsl2:i386 (1.3.0-3+b3) ... Setting up gnupg (2.2.45-2) ... Setting up libgpgme11t64:i386 (1.24.0-2) ... Setting up libcups2t64:i386 (2.4.10-2) ... Setting up libgpgmepp6t64:i386 (1.24.0-2) ... Setting up libxmu6:i386 (2:1.1.3-3+b3) ... Setting up libpython3.12-stdlib:i386 (3.12.7-3) ... Setting up preview-latex-style (13.2-1) ... Setting up python3.12 (3.12.7-3) ... Setting up debhelper (13.20) ... Setting up libxaw7:i386 (2:1.0.16-1) ... Setting up fonts-urw-base35 (20200910-8) ... Setting up libpython3-stdlib:i386 (3.12.7-1) ... Setting up libgs10-common (10.04.0~dfsg-1) ... Setting up fontconfig-config (2.15.0-1.1+b1) ... Setting up python3 (3.12.7-1) ... Setting up libfontconfig1:i386 (2.15.0-1.1+b1) ... Setting up libgs10:i386 (10.04.0~dfsg-1) ... Setting up ghostscript (10.04.0~dfsg-1) ... Setting up libcairo2:i386 (1.18.2-2) ... Setting up texlive-binaries (2024.20240313.70630+ds-5) ... 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 libpoppler140:i386 (24.08.0-3) ... Setting up poppler-utils (24.08.0-3) ... Setting up texlive-base (2024.20241115-1) ... 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/tex-ini-files/pdftexconfig.tex Setting up texlive-lang-greek (2024.20241115-1) ... Setting up texlive-font-utils (2024.20241115-1) ... Setting up texlive-latex-base (2024.20241115-1) ... Setting up texlive-latex-recommended (2024.20241115-1) ... Setting up texlive-pictures (2024.20241115-1) ... Setting up texlive-fonts-recommended (2024.20241115-1) ... Setting up texlive (2024.20241115-1) ... Setting up texlive-science (2024.20241115-1) ... Setting up texlive-latex-extra (2024.20241115-1) ... Setting up latex2html (2024.2-debian1-1) ... Processing triggers for libc-bin (2.40-3) ... Processing triggers for tex-common (6.18) ... 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 I: Building the package I: Running cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/ && env PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games" HOME="/nonexistent/first-build" dpkg-buildpackage -us -uc -b && env PATH="/usr/sbin:/usr/bin:/sbin:/bin:/usr/games" HOME="/nonexistent/first-build" dpkg-genchanges -S > ../starlink-ast_9.2.10+dfsg-2_source.changes dpkg-buildpackage: info: source package starlink-ast dpkg-buildpackage: info: source version 9.2.10+dfsg-2 dpkg-buildpackage: info: source distribution unstable dpkg-buildpackage: info: source changed by Phil Wyett dpkg-source --before-build . dpkg-buildpackage: info: host architecture i386 debian/rules clean dh clean dh_clean debian/rules binary dh binary dh_update_autotools_config debian/rules override_dh_autoreconf make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+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:36: installing 'build-aux/compile' configure.ac:27: installing 'build-aux/missing' Makefile.am: installing 'build-aux/depcomp' Makefile.am:747: warning: variable 'libstarlink_ast_drama_la_SOURCES' is defined but no program or Makefile.am:747: library has 'libstarlink_ast_drama_la' as canonical name (possible typo) Makefile.am:743: warning: variable 'libstarlink_ast_ems_la_SOURCES' is defined but no program or Makefile.am:743: library has 'libstarlink_ast_ems_la' as canonical name (possible typo) Makefile.am:748: warning: variable 'libstarlink_ast_drama_la_LDFLAGS' is defined but no program or Makefile.am:748: library has 'libstarlink_ast_drama_la' as canonical name (possible typo) Makefile.am:744: warning: variable 'libstarlink_ast_ems_la_LDFLAGS' is defined but no program or Makefile.am:744: library has 'libstarlink_ast_ems_la' as canonical name (possible typo) make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' debian/rules override_dh_auto_configure make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_auto_configure -- --with-external_pal --with-external-cminpack ./configure --build=i686-linux-gnu --prefix=/usr --includedir=\${prefix}/include --mandir=\${prefix}/share/man --infodir=\${prefix}/share/info --sysconfdir=/etc --localstatedir=/var --disable-option-checking --disable-silent-rules --libdir=\${prefix}/lib/i386-linux-gnu --runstatedir=/run --disable-maintainer-mode --disable-dependency-tracking --with-external_pal --with-external-cminpack checking for a BSD-compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking for a race-free mkdir -p... /usr/bin/mkdir -p checking for gawk... no checking for mawk... mawk checking whether make sets $(MAKE)... yes checking whether make supports nested variables... yes 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 the compiler supports GNU C... yes checking whether gcc accepts -g... yes checking for gcc option to enable C11 features... 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... i686-pc-linux-gnu checking host system type... i686-pc-linux-gnu checking how to print strings... printf checking for a sed that does not truncate output... /usr/bin/sed checking for grep that handles long lines and -e... /usr/bin/grep checking for egrep... /usr/bin/grep -E checking for fgrep... /usr/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 i686-pc-linux-gnu file names to i686-pc-linux-gnu format... func_convert_file_noop checking how to convert i686-pc-linux-gnu file names to toolchain format... func_convert_file_noop checking for /usr/bin/ld option to reload object files... -r checking for file... file 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... /usr/bin/dd checking how to truncate binary pipes... /usr/bin/dd bs=4096 count=1 checking for mt... no checking if : is a manifest tool... no checking for stdio.h... yes checking for stdlib.h... yes checking for string.h... yes checking for inttypes.h... yes checking for stdint.h... yes checking for strings.h... yes checking for sys/stat.h... yes checking for sys/types.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 ./configure: line 13540: ,: command not found ./configure: line 13579: ,: command not found 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 the compiler supports GNU Fortran... 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 pthread_create in -lpthread... yes checking for yaml_parser_initialize in -lyaml... no checking for stdarg.h... 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... 4 checking size of long long... 8 checking whether C compiler defines __func__... yes checking for perl... /usr/bin/perl checking for isnan... yes checking for gcc options needed to detect all undeclared functions... none needed 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 src/object.h config.status: creating src/f77.h config.status: creating ast_cpp config.status: creating config.h config.status: executing depfiles commands config.status: executing libtool commands make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_auto_build make -j11 make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make all-am make[2]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/astbad.o src/astbad.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-yamlchan.lo `test -f 'src/yamlchan.c' || echo './'`src/yamlchan.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-axis.lo `test -f 'src/axis.c' || echo './'`src/axis.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-box.lo `test -f 'src/box.c' || echo './'`src/box.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-channel.lo `test -f 'src/channel.c' || echo './'`src/channel.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-chebymap.lo `test -f 'src/chebymap.c' || echo './'`src/chebymap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-circle.lo `test -f 'src/circle.c' || echo './'`src/circle.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-cmpframe.lo `test -f 'src/cmpframe.c' || echo './'`src/cmpframe.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-cmpmap.lo `test -f 'src/cmpmap.c' || echo './'`src/cmpmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-cmpregion.lo `test -f 'src/cmpregion.c' || echo './'`src/cmpregion.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-dsbspecframe.lo `test -f 'src/dsbspecframe.c' || echo './'`src/dsbspecframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/channel.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/dsbspecframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-dsbspecframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/axis.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-cmpregion.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/box.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/chebymap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/yamlchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-yamlchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/circle.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-cmpmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-dssmap.lo `test -f 'src/dssmap.c' || echo './'`src/dssmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/dssmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-dssmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/yamlchan.c -fPIC -DPIC -o src/libstarlink_ast_la-yamlchan.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/dsbspecframe.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/chebymap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/dssmap.c -fPIC -DPIC -o src/libstarlink_ast_la-dssmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/circle.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/axis.c -fPIC -DPIC -o src/libstarlink_ast_la-axis.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ellipse.lo `test -f 'src/ellipse.c' || echo './'`src/ellipse.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ellipse.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/box.c -fPIC -DPIC -o src/libstarlink_ast_la-box.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-error.lo `test -f 'src/error.c' || echo './'`src/error.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpregion.c -fPIC -DPIC -o src/libstarlink_ast_la-cmpregion.o >/dev/null 2>&1 In file included from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/ellipse.c:83: src/ellipse.c: In function 'RegPins': src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/ellipse.c:1526:23: note: in expansion of macro 'astEllipse' 1526 | large_ellipse = astEllipse( frm, 1, this->centre, p1, &(this->angle), | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/ellipse.c:1526:23: note: in expansion of macro 'astEllipse' 1526 | large_ellipse = astEllipse( frm, 1, this->centre, p1, &(this->angle), | ^~~~~~~~~~ src/ellipse.c:2368:13: note: in a call to function 'astEllipse_' 2368 | AstEllipse *astEllipse_( void *frame_void, int form, const double centre[2], | ^~~~~~~~~~~ src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/ellipse.c:1534:23: note: in expansion of macro 'astEllipse' 1534 | small_ellipse = astEllipse( frm, 1, this->centre, p1, &(this->angle), | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/ellipse.c:1534:23: note: in expansion of macro 'astEllipse' 1534 | small_ellipse = astEllipse( frm, 1, this->centre, p1, &(this->angle), | ^~~~~~~~~~ src/ellipse.c:2368:13: note: in a call to function 'astEllipse_' 2368 | AstEllipse *astEllipse_( void *frame_void, int form, const double centre[2], | ^~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/error.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-error.o src/cmpframe.c: In function 'SetAttrib.part.0': src/cmpframe.c:8516:21: warning: '%d' directive writing between 1 and 11 bytes into a region of size between 10 and 1043 [-Wformat-overflow=] 8516 | nc = sprintf( buf2, "%s(%d)=%s", buf1, paxis + 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 8517 | setting+value ); | ~~~~~~~~~~~~~~~ src/cmpframe.c:8516:21: note: directive argument in the range [-2147483647, 2147483647] In file included from /usr/include/stdio.h:970, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/cmpframe.c:551: In function 'sprintf', inlined from 'SetAttrib.part.0' at src/cmpframe.c:8516:21: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output 5 or more bytes (assuming 1048) into a destination of size 1044 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fitschan.lo `test -f 'src/fitschan.c' || echo './'`src/fitschan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fitschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fitschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/channel.c -fPIC -DPIC -o src/libstarlink_ast_la-channel.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fitstable.lo `test -f 'src/fitstable.c' || echo './'`src/fitstable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fitstable.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fitstable.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fluxframe.lo `test -f 'src/fluxframe.c' || echo './'`src/fluxframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/error.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fluxframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ellipse.c -fPIC -DPIC -o src/libstarlink_ast_la-ellipse.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-frame.lo `test -f 'src/frame.c' || echo './'`src/frame.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-frameset.lo `test -f 'src/frameset.c' || echo './'`src/frameset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/frame.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-frame.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/frameset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-frameset.o In file included from src/channel.h:220, from src/fitschan.c:1439: src/fitschan.c: In function 'MakeFitsFrameSet': src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 12 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20705:16: note: in expansion of macro 'astPutFits' 20705 | astPutFits( fc, "CRPIX1 = 0", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20705:16: note: in expansion of macro 'astPutFits' 20705 | astPutFits( fc, "CRPIX1 = 0", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 12 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20706:16: note: in expansion of macro 'astPutFits' 20706 | astPutFits( fc, "CRPIX2 = 0", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20706:16: note: in expansion of macro 'astPutFits' 20706 | astPutFits( fc, "CRPIX2 = 0", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 17 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20707:16: note: in expansion of macro 'astPutFits' 20707 | astPutFits( fc, "CDELT1 = 0.0003", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20707:16: note: in expansion of macro 'astPutFits' 20707 | astPutFits( fc, "CDELT1 = 0.0003", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 17 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20708:16: note: in expansion of macro 'astPutFits' 20708 | astPutFits( fc, "CDELT2 = 0.0003", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20708:16: note: in expansion of macro 'astPutFits' 20708 | astPutFits( fc, "CDELT2 = 0.0003", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 21 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20709:16: note: in expansion of macro 'astPutFits' 20709 | astPutFits( fc, "CTYPE1 = 'RA---TAN'", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20709:16: note: in expansion of macro 'astPutFits' 20709 | astPutFits( fc, "CTYPE1 = 'RA---TAN'", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 21 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20710:16: note: in expansion of macro 'astPutFits' 20710 | astPutFits( fc, "CTYPE2 = 'DEC--TAN'", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20710:16: note: in expansion of macro 'astPutFits' 20710 | astPutFits( fc, "CTYPE2 = 'DEC--TAN'", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 16 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20711:16: note: in expansion of macro 'astPutFits' 20711 | astPutFits( fc, "RADESYS = 'FK5'", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20711:16: note: in expansion of macro 'astPutFits' 20711 | astPutFits( fc, "RADESYS = 'FK5'", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitschan.h:688:13: warning: 'astPutFits_' reading 81 bytes from a region of size 17 [-Wstringop-overread] 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20712:16: note: in expansion of macro 'astPutFits' 20712 | astPutFits( fc, "EQUINOX = 2000.0", 0 ); | ^~~~~~~~~~ src/fitschan.h:688:13: note: referencing argument 2 of type 'const char[81]' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) src/object.h:512:22: note: in definition of macro 'astRetV_' 512 | #define astRetV_(x) (x) | ^ src/fitschan.h:688:1: note: in expansion of macro 'astINVOKE' 688 | astINVOKE(V,astPutFits_(astCheckFitsChan(this),card,overwrite,STATUS_PTR)) | ^~~~~~~~~ src/fitschan.c:20712:16: note: in expansion of macro 'astPutFits' 20712 | astPutFits( fc, "EQUINOX = 2000.0", 0 ); | ^~~~~~~~~~ src/fitschan.c:43966:6: note: in a call to function 'astPutFits_' 43966 | void astPutFits_( AstFitsChan *this, const char *card, int overwrite, int *status ){ | ^~~~~~~~~~~ src/fitstable.c: In function 'GetTableHeader': src/fitstable.c:2273:34: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 2273 | sprintf( keyword, "TFORM%d", icol ); | ^~ In function 'UpdateHeader', inlined from 'GetTableHeader' at src/fitstable.c:1540:4: src/fitstable.c:2273:28: note: directive argument in the range [1, 2147483647] 2273 | sprintf( keyword, "TFORM%d", icol ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:970, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/fitstable.c:105: In function 'sprintf', inlined from 'UpdateHeader' at src/fitstable.c:2273:10, inlined from 'GetTableHeader' at src/fitstable.c:1540:4: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/fitstable.c: In function 'GetTableHeader': src/fitstable.c:2277:34: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 2277 | sprintf( keyword, "TTYPE%d", icol ); | ^~ In function 'UpdateHeader', inlined from 'GetTableHeader' at src/fitstable.c:1540:4: src/fitstable.c:2277:28: note: directive argument in the range [1, 2147483647] 2277 | sprintf( keyword, "TTYPE%d", icol ); | ^~~~~~~~~ In function 'sprintf', inlined from 'UpdateHeader' at src/fitstable.c:2277:10, inlined from 'GetTableHeader' at src/fitstable.c:1540:4: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/fitstable.c: In function 'GetTableHeader': src/fitstable.c:2282:37: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 2282 | sprintf( keyword, "TUNIT%d", icol ); | ^~ In function 'UpdateHeader', inlined from 'GetTableHeader' at src/fitstable.c:1540:4: src/fitstable.c:2282:31: note: directive argument in the range [1, 2147483647] 2282 | sprintf( keyword, "TUNIT%d", icol ); | ^~~~~~~~~ In function 'sprintf', inlined from 'UpdateHeader' at src/fitstable.c:2282:13, inlined from 'GetTableHeader' at src/fitstable.c:1540:4: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/fitstable.c: In function 'GetTableHeader': src/fitstable.c:2293:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 2293 | sprintf( keyword, "TNULL%d", icol ); | ^~ In function 'UpdateHeader', inlined from 'GetTableHeader' at src/fitstable.c:1540:4: src/fitstable.c:2293:34: note: directive argument in the range [1, 2147483647] 2293 | sprintf( keyword, "TNULL%d", icol ); | ^~~~~~~~~ In function 'sprintf', inlined from 'UpdateHeader' at src/fitstable.c:2293:16, inlined from 'GetTableHeader' at src/fitstable.c:1540:4: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 7 and 16 bytes into a destination of size 14 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/fitstable.c: In function 'GetTableHeader': src/fitstable.c:2319:41: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] 2319 | sprintf( keyword, "TDIM%d", icol ); | ^ In function 'sprintf', inlined from 'UpdateHeader' at src/fitstable.c:2319:16, inlined from 'GetTableHeader' at src/fitstable.c:1540:4: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 6 and 15 bytes into a destination of size 14 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-globals.lo `test -f 'src/globals.c' || echo './'`src/globals.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-grismmap.lo `test -f 'src/grismmap.c' || echo './'`src/grismmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/globals.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-globals.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grismmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-grismmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fitstable.c -fPIC -DPIC -o src/libstarlink_ast_la-fitstable.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpframe.c -fPIC -DPIC -o src/libstarlink_ast_la-cmpframe.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-interval.lo `test -f 'src/interval.c' || echo './'`src/interval.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/globals.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/interval.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-interval.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fluxframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fluxframe.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-intramap.lo `test -f 'src/intramap.c' || echo './'`src/intramap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-keymap.lo `test -f 'src/keymap.c' || echo './'`src/keymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/intramap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-intramap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/keymap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-keymap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-loader.lo `test -f 'src/loader.c' || echo './'`src/loader.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/loader.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-loader.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-lutmap.lo `test -f 'src/lutmap.c' || echo './'`src/lutmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/intramap.c -fPIC -DPIC -o src/libstarlink_ast_la-intramap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/loader.c -fPIC -DPIC -o src/libstarlink_ast_la-loader.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/lutmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-lutmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-mapping.lo `test -f 'src/mapping.c' || echo './'`src/mapping.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grismmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mapping.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mapping.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-mathmap.lo `test -f 'src/mathmap.c' || echo './'`src/mathmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mathmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mathmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-matrixmap.lo `test -f 'src/matrixmap.c' || echo './'`src/matrixmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/matrixmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/lutmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/interval.c -fPIC -DPIC -o src/libstarlink_ast_la-interval.o >/dev/null 2>&1 src/fitschan.c: In function 'FormatKey': src/fitschan.c:11193:64: warning: '__builtin___sprintf_chk' may write a terminating nul past the end of the destination [-Wformat-overflow=] 11193 | if( len >= 0 && ( nc = sprintf( formatkey_buff + len, "%d", c1 ) ) >= 0 ){ | ^ In file included from /usr/include/stdio.h:970, from src/object.h:350: In function 'sprintf', inlined from 'FormatKey' at src/fitschan.c:11193:30: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 2 and 11 bytes into a destination of size 10 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/fitschan.c: In function 'FormatKey': src/fitschan.c:11202:66: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 11202 | if( len >= 0 && ( nc = sprintf( formatkey_buff + len, "_%d", c2 ) ) >= 0 ){ | ^~ src/fitschan.c:11202:64: note: directive argument in the range [0, 2147483647] 11202 | if( len >= 0 && ( nc = sprintf( formatkey_buff + len, "_%d", c2 ) ) >= 0 ){ | ^~~~~ In function 'sprintf', inlined from 'FormatKey' at src/fitschan.c:11202:33: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 3 and 12 bytes into a destination of size 10 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-memory.lo `test -f 'src/memory.c' || echo './'`src/memory.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/memory.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-memory.o src/memory.c: In function 'astFreeDouble_': src/memory.c:2654:29: warning: format '%lu' expects argument of type 'long unsigned int', but argument 4 has type 'size_t' {aka 'unsigned int'} [-Wformat=] 2654 | astError( AST__MEMIN, "Invalid attempt to free double allocated " | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 2655 | "memory: the supplied memory size (%lu bytes) is not " 2656 | "an integer multiple of %lu.", status, size, | ~~~~ | | | size_t {aka unsigned int} src/memory.c:2655:54: note: format string is defined here 2655 | "memory: the supplied memory size (%lu bytes) is not " | ~~^ | | | long unsigned int | %u src/memory.c:2654:29: warning: format '%lu' expects argument of type 'long unsigned int', but argument 5 has type 'unsigned int' [-Wformat=] 2654 | astError( AST__MEMIN, "Invalid attempt to free double allocated " | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ...... 2657 | sizeof( void * ) ); | ~~~~~~~~~~~~~~~~ | | | unsigned int src/memory.c:2656:43: note: format string is defined here 2656 | "an integer multiple of %lu.", status, size, | ~~^ | | | long unsigned int | %u /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-moc.lo `test -f 'src/moc.c' || echo './'`src/moc.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/moc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-moc.o src/fitschan.c: In function 'WcsOthers.constprop': src/fitschan.c:37859:37: warning: '%s' directive writing up to 99 bytes into a region of size between 0 and 499 [-Wformat-overflow=] 37859 | sprintf( buf, "%s-%s", newdom, buf2 ); | ^~ ~~~~ In function 'sprintf', inlined from 'WcsOthers.constprop' at src/fitschan.c:37859:19: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 2 and 600 bytes into a destination of size 500 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/moc.c: In function 'AddCell': /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-mocchan.lo `test -f 'src/mocchan.c' || echo './'`src/mocchan.c src/moc.c:615:29: warning: format '%zu' expects argument of type 'size_t', but argument 6 has type 'long int' [-Wformat=] 615 | astError( AST__INVAR, "astAddCell(%s): Invalid value (%" PRId64 ") " | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/moc.c:617:41: note: format string is defined here 617 | "than 0 and less than %zu.", status, astGetClass( this ), | ~~^ | | | unsigned int | %lu libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mocchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mocchan.o src/moc.c: In function 'TestCell': src/moc.c:8964:29: warning: format '%zu' expects argument of type 'size_t', but argument 6 has type 'long int' [-Wformat=] 8964 | astError( AST__INVAR, "astTestCell(%s): Invalid value (%" PRId64 ") " | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/moc.c:8966:41: note: format string is defined here 8966 | "than 0 and less than %zu.", status, astGetClass( this ), | ~~^ | | | unsigned int | %lu src/memory.c: In function 'ChrMatcher': src/memory.c:3396:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size 6 [-Wformat-overflow=] 3396 | sprintf( stemp, ".*($%d).*", dollar ); | ^~ src/memory.c:3396:35: note: directive argument in the range [1, 1073741824] 3396 | sprintf( stemp, ".*($%d).*", dollar ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:970, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/memory.c:218: In function 'sprintf', inlined from 'ChrMatcher' at src/memory.c:3396:19: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 9 and 18 bytes into a destination of size 10 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/frameset.c -fPIC -DPIC -o src/libstarlink_ast_la-frameset.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mocchan.c -fPIC -DPIC -o src/libstarlink_ast_la-mocchan.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/memory.c -fPIC -DPIC -o src/libstarlink_ast_la-memory.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-normmap.lo `test -f 'src/normmap.c' || echo './'`src/normmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/frame.c -fPIC -DPIC -o src/libstarlink_ast_la-frame.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/matrixmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/normmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-normmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-nullregion.lo `test -f 'src/nullregion.c' || echo './'`src/nullregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/nullregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-nullregion.o src/fitschan.c: In function 'Match.part.0': src/fitschan.c:21988:33: warning: '%d' directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 21988 | sprintf( match_fmt, "%%%dd", (int) ( a - test ) ); | ^~ src/fitschan.c:21988:30: note: directive argument in the range [1, 2147483647] 21988 | sprintf( match_fmt, "%%%dd", (int) ( a - test ) ); | ^~~~~~~ In function 'sprintf', inlined from 'Match.part.0' at src/fitschan.c:21988:10: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 4 and 13 bytes into a destination of size 10 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/normmap.c -fPIC -DPIC -o src/libstarlink_ast_la-normmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-object.lo `test -f 'src/object.c' || echo './'`src/object.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/object.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-object.o src/keymap.c: In function 'Dump': src/keymap.c:2824:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2824 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2824:35: note: directive argument in the range [1, 2147483647] 2824 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:970, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:251: In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2824:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2838:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2838 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2838:35: note: directive argument in the range [1, 2147483647] 2838 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2838:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2810:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2810 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2810:35: note: directive argument in the range [1, 2147483647] 2810 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2810:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2917:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2917 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2917:35: note: directive argument in the range [1, 2147483647] 2917 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2917:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2870:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2870 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2870:35: note: directive argument in the range [1, 2147483647] 2870 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2870:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2901:43: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2901 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2901:38: note: directive argument in the range [1, 2147483647] 2901 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2901:23, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2884:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2884 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2884:35: note: directive argument in the range [1, 2147483647] 2884 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2884:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2855:43: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2855 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2855:38: note: directive argument in the range [1, 2147483647] 2855 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2855:23, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ src/keymap.c: In function 'Dump': src/keymap.c:2796:40: warning: '%d' directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2796 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ In function 'DumpEntry', inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: src/keymap.c:2796:35: note: directive argument in the range [1, 2147483647] 2796 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In function 'sprintf', inlined from 'DumpEntry' at src/keymap.c:2796:20, inlined from 'Dump' at src/keymap.c:10521:10, inlined from 'Dump' at src/keymap.c:10430:13: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 5 and 23 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/nullregion.c -fPIC -DPIC -o src/libstarlink_ast_la-nullregion.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-pcdmap.lo `test -f 'src/pcdmap.c' || echo './'`src/pcdmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pcdmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-pcdmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mathmap.c -fPIC -DPIC -o src/libstarlink_ast_la-mathmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-permmap.lo `test -f 'src/permmap.c' || echo './'`src/permmap.c src/fitschan.c: In function 'CnvValue.part.0.isra': src/fitschan.c:7194:47: warning: '%s' directive writing up to 80 bytes into a region of size between 0 and 80 [-Wformat-overflow=] 7194 | (void) sprintf( cnvtype_text, "%s %s", cnvtype_text0, cnvtype_text1 ); | ^~ In function 'sprintf', inlined from 'CnvType' at src/fitschan.c:7194:20, inlined from 'CnvValue.part.0.isra' at src/fitschan.c:6882:11: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 2 and 162 bytes into a destination of size 81 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/keymap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/permmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-permmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pcdmap.c -fPIC -DPIC -o src/libstarlink_ast_la-pcdmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-plot.lo `test -f 'src/plot.c' || echo './'`src/plot.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-plot.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/object.c -fPIC -DPIC -o src/libstarlink_ast_la-object.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/permmap.c -fPIC -DPIC -o src/libstarlink_ast_la-permmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-plot3d.lo `test -f 'src/plot3d.c' || echo './'`src/plot3d.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot3d.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-plot3d.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-pointlist.lo `test -f 'src/pointlist.c' || echo './'`src/pointlist.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointlist.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-pointlist.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-pointset.lo `test -f 'src/pointset.c' || echo './'`src/pointset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-pointset.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-polygon.lo `test -f 'src/polygon.c' || echo './'`src/polygon.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/polygon.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-polygon.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-polymap.lo `test -f 'src/polymap.c' || echo './'`src/polymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/polymap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-polymap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointset.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointlist.c -fPIC -DPIC -o src/libstarlink_ast_la-pointlist.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-prism.lo `test -f 'src/prism.c' || echo './'`src/prism.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/prism.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-prism.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ratemap.lo `test -f 'src/ratemap.c' || echo './'`src/ratemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ratemap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ratemap.o src/moc.c: In function 'astAddMocText_': src/moc.c:1523:77: warning: '%.30s' directive argument is null [-Wformat-overflow=] 1523 | astError( AST__INMOC, "%s(%s): Invalid string MOC supplied: '%.30s...'", | ^~~~~ src/moc.c:1513:75: warning: '%.30s' directive argument is null [-Wformat-overflow=] 1513 | astError( AST__INMOC, "%s(%s): Invalid JSON MOC supplied: '%.30s...'", | ^~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot3d.c -fPIC -DPIC -o src/libstarlink_ast_la-plot3d.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ratemap.c -fPIC -DPIC -o src/libstarlink_ast_la-ratemap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/prism.c -fPIC -DPIC -o src/libstarlink_ast_la-prism.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-region.lo `test -f 'src/region.c' || echo './'`src/region.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/region.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-region.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-selectormap.lo `test -f 'src/selectormap.c' || echo './'`src/selectormap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/selectormap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/polymap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/selectormap.c -fPIC -DPIC -o src/libstarlink_ast_la-selectormap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-shiftmap.lo `test -f 'src/shiftmap.c' || echo './'`src/shiftmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/shiftmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-shiftmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-skyaxis.lo `test -f 'src/skyaxis.c' || echo './'`src/skyaxis.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/skyaxis.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-skyaxis.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-skyframe.lo `test -f 'src/skyframe.c' || echo './'`src/skyframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/shiftmap.c -fPIC -DPIC -o src/libstarlink_ast_la-shiftmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/skyframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-skyframe.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-slamap.lo `test -f 'src/slamap.c' || echo './'`src/slamap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/slamap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/skyaxis.c -fPIC -DPIC -o src/libstarlink_ast_la-skyaxis.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-specfluxframe.lo `test -f 'src/specfluxframe.c' || echo './'`src/specfluxframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specfluxframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specfluxframe.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-specframe.lo `test -f 'src/specframe.c' || echo './'`src/specframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specfluxframe.c -fPIC -DPIC -o src/libstarlink_ast_la-specfluxframe.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-specmap.lo `test -f 'src/specmap.c' || echo './'`src/specmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-sphmap.lo `test -f 'src/sphmap.c' || echo './'`src/sphmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/sphmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/slamap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/region.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/skyframe.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/sphmap.c -fPIC -DPIC -o src/libstarlink_ast_la-sphmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/moc.c -fPIC -DPIC -o src/libstarlink_ast_la-moc.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specframe.c -fPIC -DPIC -o src/libstarlink_ast_la-specframe.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specmap.c -fPIC -DPIC -o src/libstarlink_ast_la-specmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stc.lo `test -f 'src/stc.c' || echo './'`src/stc.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stc.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stc.c -fPIC -DPIC -o src/libstarlink_ast_la-stc.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stccatalogentrylocation.lo `test -f 'src/stccatalogentrylocation.c' || echo './'`src/stccatalogentrylocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stccatalogentrylocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stccatalogentrylocation.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stcobsdatalocation.lo `test -f 'src/stcobsdatalocation.c' || echo './'`src/stcobsdatalocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcobsdatalocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcobsdatalocation.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stcresourceprofile.lo `test -f 'src/stcresourceprofile.c' || echo './'`src/stcresourceprofile.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stccatalogentrylocation.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcresourceprofile.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcresourceprofile.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stcschan.lo `test -f 'src/stcschan.c' || echo './'`src/stcschan.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-stcsearchlocation.lo `test -f 'src/stcsearchlocation.c' || echo './'`src/stcsearchlocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcobsdatalocation.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcresourceprofile.c -fPIC -DPIC -o src/libstarlink_ast_la-stcresourceprofile.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcsearchlocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcsearchlocation.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-switchmap.lo `test -f 'src/switchmap.c' || echo './'`src/switchmap.c In file included from src/frame.h:554, from src/stcschan.c:216: src/stcschan.c: In function 'MakeSpaceRegion': src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/stcschan.c:2000:30: note: in expansion of macro 'astEllipse' 2000 | result = (AstRegion *) astEllipse( frm, 1, vec1, vec2, &val3, NULL, " ", | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/stcschan.c:2000:30: note: in expansion of macro 'astEllipse' 2000 | result = (AstRegion *) astEllipse( frm, 1, vec1, vec2, &val3, NULL, " ", | ^~~~~~~~~~ In file included from src/globals.h:22, from src/stcschan.c:217: src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-table.lo `test -f 'src/table.c' || echo './'`src/table.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/switchmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcsearchlocation.c -fPIC -DPIC -o src/libstarlink_ast_la-stcsearchlocation.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/table.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-table.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-timeframe.lo `test -f 'src/timeframe.c' || echo './'`src/timeframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fitschan.c -fPIC -DPIC -o src/libstarlink_ast_la-fitschan.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-timemap.lo `test -f 'src/timemap.c' || echo './'`src/timemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/timeframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/timemap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot.c -fPIC -DPIC -o src/libstarlink_ast_la-plot.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-tranmap.lo `test -f 'src/tranmap.c' || echo './'`src/tranmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/tranmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-tranmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/switchmap.c -fPIC -DPIC -o src/libstarlink_ast_la-switchmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/tranmap.c -fPIC -DPIC -o src/libstarlink_ast_la-tranmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/table.c -fPIC -DPIC -o src/libstarlink_ast_la-table.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-unit.lo `test -f 'src/unit.c' || echo './'`src/unit.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unit.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-unit.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-unitmap.lo `test -f 'src/unitmap.c' || echo './'`src/unitmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unitmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/timeframe.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/timemap.c -fPIC -DPIC -o src/libstarlink_ast_la-timemap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unitmap.c -fPIC -DPIC -o src/libstarlink_ast_la-unitmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcschan.c -fPIC -DPIC -o src/libstarlink_ast_la-stcschan.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-unitnormmap.lo `test -f 'src/unitnormmap.c' || echo './'`src/unitnormmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unitnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-unitnormmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-wcsmap.lo `test -f 'src/wcsmap.c' || echo './'`src/wcsmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/wcsmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unit.c -fPIC -DPIC -o src/libstarlink_ast_la-unit.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-winmap.lo `test -f 'src/winmap.c' || echo './'`src/winmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-xml.lo `test -f 'src/xml.c' || echo './'`src/xml.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unitnormmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xml.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/winmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-winmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-xmlchan.lo `test -f 'src/xmlchan.c' || echo './'`src/xmlchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xmlchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-xmlchan.o In file included from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/xmlchan.c:210: src/xmlchan.c: In function 'Position2DReader': src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6693:39: note: in expansion of macro 'astEllipse' 6693 | result = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6693:39: note: in expansion of macro 'astEllipse' 6693 | result = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ In file included from src/globals.h:22: src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6740:34: note: in expansion of macro 'astEllipse' 6740 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6740:34: note: in expansion of macro 'astEllipse' 6740 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6788:34: note: in expansion of macro 'astEllipse' 6788 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6788:34: note: in expansion of macro 'astEllipse' 6788 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6836:34: note: in expansion of macro 'astEllipse' 6836 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:6836:34: note: in expansion of macro 'astEllipse' 6836 | r = (AstRegion *) astEllipse( frm, 1, cen, hw, &pa, | ^~~~~~~~~~ src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ src/xmlchan.c: In function 'EllipseReader': src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:3822:30: note: in expansion of macro 'astEllipse' 3822 | new = (AstRegion *) astEllipse( frm, 1, cen, rad, &pa, NULL, "", status ); | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:3822:30: note: in expansion of macro 'astEllipse' 3822 | new = (AstRegion *) astEllipse( frm, 1, cen, rad, &pa, NULL, "", status ); | ^~~~~~~~~~ src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ src/object.h:511:21: warning: 'astEllipse_' reading 16 bytes from a region of size 8 [-Wstringop-overread] 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:3834:30: note: in expansion of macro 'astEllipse' 3834 | new = (AstRegion *) astEllipse( cfrm, 1, cen, rad, &pa, NULL, "", status ); | ^~~~~~~~~~ src/object.h:511:21: note: referencing argument 5 of type 'const double[2]' 511 | #define astRetF_(x) (x) src/object.h:504:37: note: in expansion of macro 'astRetF_' 504 | #define astINVOKE(rettype,function) astRet##rettype##_(function) | ^~~~~~ src/ellipse.h:210:20: note: in expansion of macro 'astINVOKE' 210 | #define astEllipse astINVOKE(F,astEllipse_) | ^~~~~~~~~ src/xmlchan.c:3834:30: note: in expansion of macro 'astEllipse' 3834 | new = (AstRegion *) astEllipse( cfrm, 1, cen, rad, &pa, NULL, "", status ); | ^~~~~~~~~~ src/ellipse.h:160:13: note: in a call to function 'astEllipse_' 160 | AstEllipse *astEllipse_( void *, int, const double[2], const double[2], const double[2], AstRegion *, const char *, int *, ...); | ^~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/wcsmap.c -fPIC -DPIC -o src/libstarlink_ast_la-wcsmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/winmap.c -fPIC -DPIC -o src/libstarlink_ast_la-winmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xml.c -fPIC -DPIC -o src/libstarlink_ast_la-xml.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-xphmap.lo `test -f 'src/xphmap.c' || echo './'`src/xphmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xphmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-xphmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-zoommap.lo `test -f 'src/zoommap.c' || echo './'`src/zoommap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/zoommap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-zoommap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xphmap.c -fPIC -DPIC -o src/libstarlink_ast_la-xphmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fyamlchan.lo `test -f 'src/fyamlchan.c' || echo './'`src/fyamlchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/zoommap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fyamlchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fyamlchan.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-c2f77.lo `test -f 'src/c2f77.c' || echo './'`src/c2f77.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fyamlchan.c -fPIC -DPIC -o src/libstarlink_ast_la-fyamlchan.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/c2f77.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-c2f77.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fbox.lo `test -f 'src/fbox.c' || echo './'`src/fbox.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/c2f77.c -fPIC -DPIC -o src/libstarlink_ast_la-c2f77.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fchannel.lo `test -f 'src/fchannel.c' || echo './'`src/fchannel.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fbox.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fchannel.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fchannel.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fchebymap.lo `test -f 'src/fchebymap.c' || echo './'`src/fchebymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fbox.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fchannel.c -fPIC -DPIC -o src/libstarlink_ast_la-fchannel.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fchebymap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fchebymap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fcircle.lo `test -f 'src/fcircle.c' || echo './'`src/fcircle.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fcmpframe.lo `test -f 'src/fcmpframe.c' || echo './'`src/fcmpframe.c src/xmlchan.c: In function 'StcMetadataReader': src/xmlchan.c:7930:50: warning: ')' directive writing 1 byte into a region of size between 0 and 8 [-Wformat-overflow=] 7930 | sprintf( orgatt, "TimeOrigin(%d)", i + 1 ); | ^ In file included from /usr/include/stdio.h:970, from src/object.h:350: In function 'sprintf', inlined from 'ReCentreAnc' at src/xmlchan.c:7930:19, inlined from 'StcMetadataReader' at src/xmlchan.c:10830:7: /usr/include/i386-linux-gnu/bits/stdio2.h:30:10: note: '__builtin___sprintf_chk' output between 14 and 22 bytes into a destination of size 20 30 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 31 | __glibc_objsize (__s), __fmt, | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 32 | __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fchebymap.c -fPIC -DPIC -o src/libstarlink_ast_la-fchebymap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fcmpmap.lo `test -f 'src/fcmpmap.c' || echo './'`src/fcmpmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcircle.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fcircle.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fcmpregion.lo `test -f 'src/fcmpregion.c' || echo './'`src/fcmpregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpframe.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcircle.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fcmpregion.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fdsbspecframe.lo `test -f 'src/fdsbspecframe.c' || echo './'`src/fdsbspecframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fcmpmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fdssmap.lo `test -f 'src/fdssmap.c' || echo './'`src/fdssmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpregion.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fdssmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fdssmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fellipse.lo `test -f 'src/fellipse.c' || echo './'`src/fellipse.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ferror.lo `test -f 'src/ferror.c' || echo './'`src/ferror.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fdsbspecframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fdsbspecframe.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ffitschan.lo `test -f 'src/ffitschan.c' || echo './'`src/ffitschan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fdssmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fdssmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ferror.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fellipse.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fellipse.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fdsbspecframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fdsbspecframe.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ffitstable.lo `test -f 'src/ffitstable.c' || echo './'`src/ffitstable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ferror.c -fPIC -DPIC -o src/libstarlink_ast_la-ferror.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffitschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ffitschan.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ffluxframe.lo `test -f 'src/ffluxframe.c' || echo './'`src/ffluxframe.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fframe.lo `test -f 'src/fframe.c' || echo './'`src/fframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffitstable.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ffitstable.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fellipse.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffluxframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fframe.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fframeset.lo `test -f 'src/fframeset.c' || echo './'`src/fframeset.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xmlchan.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffluxframe.c -fPIC -DPIC -o src/libstarlink_ast_la-ffluxframe.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffitstable.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframeset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fframeset.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fgrismmap.lo `test -f 'src/fgrismmap.c' || echo './'`src/fgrismmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-finterval.lo `test -f 'src/finterval.c' || echo './'`src/finterval.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fintramap.lo `test -f 'src/fintramap.c' || echo './'`src/fintramap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fintramap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/finterval.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fgrismmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fframe.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffitschan.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframeset.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fintramap.c -fPIC -DPIC -o src/libstarlink_ast_la-fintramap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fgrismmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fgrismmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/finterval.c -fPIC -DPIC -o src/libstarlink_ast_la-finterval.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fkeymap.lo `test -f 'src/fkeymap.c' || echo './'`src/fkeymap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-flutmap.lo `test -f 'src/flutmap.c' || echo './'`src/flutmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fmapping.lo `test -f 'src/fmapping.c' || echo './'`src/fmapping.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fmathmap.lo `test -f 'src/fmathmap.c' || echo './'`src/fmathmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmathmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/flutmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-flutmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fkeymap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmapping.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fmapping.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fmatrixmap.lo `test -f 'src/fmatrixmap.c' || echo './'`src/fmatrixmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/flutmap.c -fPIC -DPIC -o src/libstarlink_ast_la-flutmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmathmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fmathmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmatrixmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fmatrixmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fmoc.lo `test -f 'src/fmoc.c' || echo './'`src/fmoc.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fmocchan.lo `test -f 'src/fmocchan.c' || echo './'`src/fmocchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmatrixmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fmatrixmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fnormmap.lo `test -f 'src/fnormmap.c' || echo './'`src/fnormmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmoc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fmoc.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmocchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fmocchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fnormmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fnullregion.lo `test -f 'src/fnullregion.c' || echo './'`src/fnullregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmocchan.c -fPIC -DPIC -o src/libstarlink_ast_la-fmocchan.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnormmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fnormmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fobject.lo `test -f 'src/fobject.c' || echo './'`src/fobject.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnullregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fnullregion.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fpcdmap.lo `test -f 'src/fpcdmap.c' || echo './'`src/fpcdmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fobject.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnullregion.c -fPIC -DPIC -o src/libstarlink_ast_la-fnullregion.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpcdmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmoc.c -fPIC -DPIC -o src/libstarlink_ast_la-fmoc.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fkeymap.c -fPIC -DPIC -o src/libstarlink_ast_la-fkeymap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fpermmap.lo `test -f 'src/fpermmap.c' || echo './'`src/fpermmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpcdmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fpcdmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fplot.lo `test -f 'src/fplot.c' || echo './'`src/fplot.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpermmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fplot.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fplot.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fobject.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpermmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fpermmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fplot3d.lo `test -f 'src/fplot3d.c' || echo './'`src/fplot3d.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fpointlist.lo `test -f 'src/fpointlist.c' || echo './'`src/fpointlist.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fplot3d.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpointlist.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fplot3d.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fplot.c -fPIC -DPIC -o src/libstarlink_ast_la-fplot.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fpolygon.lo `test -f 'src/fpolygon.c' || echo './'`src/fpolygon.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpointlist.c -fPIC -DPIC -o src/libstarlink_ast_la-fpointlist.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fpolymap.lo `test -f 'src/fpolymap.c' || echo './'`src/fpolymap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmapping.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpolygon.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fpolygon.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fprism.lo `test -f 'src/fprism.c' || echo './'`src/fprism.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fratemap.lo `test -f 'src/fratemap.c' || echo './'`src/fratemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpolymap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fprism.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fratemap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpolymap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fprism.c -fPIC -DPIC -o src/libstarlink_ast_la-fprism.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fregion.lo `test -f 'src/fregion.c' || echo './'`src/fregion.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fratemap.c -fPIC -DPIC -o src/libstarlink_ast_la-fratemap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fselectormap.lo `test -f 'src/fselectormap.c' || echo './'`src/fselectormap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fshiftmap.lo `test -f 'src/fshiftmap.c' || echo './'`src/fshiftmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fregion.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fskyframe.lo `test -f 'src/fskyframe.c' || echo './'`src/fskyframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fshiftmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fselectormap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fselectormap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fskyframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fskyframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fselectormap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fshiftmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpolygon.c -fPIC -DPIC -o src/libstarlink_ast_la-fpolygon.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fskyframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fskyframe.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fslamap.lo `test -f 'src/fslamap.c' || echo './'`src/fslamap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fspecfluxframe.lo `test -f 'src/fspecfluxframe.c' || echo './'`src/fspecfluxframe.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fspecframe.lo `test -f 'src/fspecframe.c' || echo './'`src/fspecframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fslamap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fslamap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecfluxframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fslamap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecfluxframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fspecfluxframe.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fspecframe.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fspecmap.lo `test -f 'src/fspecmap.c' || echo './'`src/fspecmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fsphmap.lo `test -f 'src/fsphmap.c' || echo './'`src/fsphmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fregion.c -fPIC -DPIC -o src/libstarlink_ast_la-fregion.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecframe.c -fPIC -DPIC -o src/libstarlink_ast_la-fspecframe.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fsphmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fsphmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstc.lo `test -f 'src/fstc.c' || echo './'`src/fstc.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fspecmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstccatalogentrylocation.lo `test -f 'src/fstccatalogentrylocation.c' || echo './'`src/fstccatalogentrylocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fsphmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fsphmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstcobsdatalocation.lo `test -f 'src/fstcobsdatalocation.c' || echo './'`src/fstcobsdatalocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstccatalogentrylocation.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstc.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstcresourceprofile.lo `test -f 'src/fstcresourceprofile.c' || echo './'`src/fstcresourceprofile.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcobsdatalocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcobsdatalocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstccatalogentrylocation.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstc.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcresourceprofile.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcobsdatalocation.c -fPIC -DPIC -o src/libstarlink_ast_la-fstcobsdatalocation.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstcschan.lo `test -f 'src/fstcschan.c' || echo './'`src/fstcschan.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fstcsearchlocation.lo `test -f 'src/fstcsearchlocation.c' || echo './'`src/fstcsearchlocation.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcresourceprofile.c -fPIC -DPIC -o src/libstarlink_ast_la-fstcresourceprofile.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fswitchmap.lo `test -f 'src/fswitchmap.c' || echo './'`src/fswitchmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ftable.lo `test -f 'src/ftable.c' || echo './'`src/ftable.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcschan.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ftimeframe.lo `test -f 'src/ftimeframe.c' || echo './'`src/ftimeframe.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcsearchlocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcsearchlocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fswitchmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fswitchmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ftimemap.lo `test -f 'src/ftimemap.c' || echo './'`src/ftimemap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftable.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcschan.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimeframe.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcsearchlocation.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimemap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ftimemap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-ftranmap.lo `test -f 'src/ftranmap.c' || echo './'`src/ftranmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fswitchmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fswitchmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-funitmap.lo `test -f 'src/funitmap.c' || echo './'`src/funitmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimeframe.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimemap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftranmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ftranmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-funitnormmap.lo `test -f 'src/funitnormmap.c' || echo './'`src/funitnormmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fwcsmap.lo `test -f 'src/fwcsmap.c' || echo './'`src/fwcsmap.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fwinmap.lo `test -f 'src/fwinmap.c' || echo './'`src/fwinmap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/funitmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftable.c -fPIC -DPIC -o src/libstarlink_ast_la-ftable.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fxmlchan.lo `test -f 'src/fxmlchan.c' || echo './'`src/fxmlchan.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/funitnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-funitnormmap.o /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_la-fzoommap.lo `test -f 'src/fzoommap.c' || echo './'`src/fzoommap.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftranmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fwcsmap.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fwinmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fwinmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/funitmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fxmlchan.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fzoommap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fzoommap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/funitnormmap.c -fPIC -DPIC -o src/libstarlink_ast_la-funitnormmap.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o wcslib/libstarlink_ast_la-proj.lo `test -f 'wcslib/proj.c' || echo './'`wcslib/proj.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fwcsmap.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fwinmap.c -fPIC -DPIC -o src/libstarlink_ast_la-fwinmap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fxmlchan.c -fPIC -DPIC -o src/libstarlink_ast_la-fxmlchan.o >/dev/null 2>&1 /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o wcslib/libstarlink_ast_la-tpn.lo `test -f 'wcslib/tpn.c' || echo './'`wcslib/tpn.c /bin/bash ./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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o wcslib/libstarlink_ast_la-wcstrig.lo `test -f 'wcslib/wcstrig.c' || echo './'`wcslib/wcstrig.c /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_err_la-err_null.lo `test -f 'src/err_null.c' || echo './'`src/err_null.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fzoommap.c -fPIC -DPIC -o src/libstarlink_ast_la-fzoommap.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/proj.c -fPIC -DPIC -o wcslib/.libs/libstarlink_ast_la-proj.o /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_grf3d_la-grf3d.lo `test -f 'src/grf3d.c' || echo './'`src/grf3d.c /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_grf_2_0_la-grf_2.0.lo `test -f 'src/grf_2.0.c' || echo './'`src/grf_2.0.c /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_grf_3_2_la-grf_3.2.lo `test -f 'src/grf_3.2.c' || echo './'`src/grf_3.2.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/tpn.c -fPIC -DPIC -o wcslib/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/wcstrig.c -fPIC -DPIC -o wcslib/.libs/libstarlink_ast_la-wcstrig.o /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_grf_5_6_la-grf_5.6.lo `test -f 'src/grf_5.6.c' || echo './'`src/grf_5.6.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/err_null.c -fPIC -DPIC -o src/.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 -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf3d.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_3.2.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_2.0.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/err_null.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_3.2.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_5.6.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf3d.c -fPIC -DPIC -o src/libstarlink_ast_grf3d_la-grf3d.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/wcstrig.c -fPIC -DPIC -o wcslib/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_2.0.c -fPIC -DPIC -o src/libstarlink_ast_grf_2_0_la-grf_2.0.o >/dev/null 2>&1 /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_pgplot_la-grf_pgplot.lo `test -f 'src/grf_pgplot.c' || echo './'`src/grf_pgplot.c /bin/bash ./libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o src/libstarlink_ast_pgplot3d_la-grf3d_pgplot.lo `test -f 'src/grf3d_pgplot.c' || echo './'`src/grf3d_pgplot.c libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_5.6.c -fPIC -DPIC -o src/libstarlink_ast_grf_5_6_la-grf_5.6.o >/dev/null 2>&1 /usr/bin/perl ./makeh -s . src/xml.h wcslib/wcstrig.h wcslib/proj.h src/memory.h src/error.h src/globals.h src/unit.h ast_err.h src/version.h src/object.h src/keymap.h src/table.h src/fitstable.h src/pointset.h src/axis.h src/skyaxis.h src/mapping.h src/cmpmap.h src/dssmap.h src/grismmap.h src/intramap.h src/lutmap.h src/mathmap.h src/matrixmap.h src/pcdmap.h src/permmap.h src/polymap.h src/chebymap.h src/ratemap.h src/normmap.h src/shiftmap.h src/slamap.h src/specmap.h src/sphmap.h src/timemap.h src/selectormap.h src/switchmap.h src/tranmap.h src/unitmap.h src/unitnormmap.h src/wcsmap.h src/winmap.h src/xphmap.h src/zoommap.h src/frame.h src/cmpframe.h src/specfluxframe.h src/fluxframe.h src/frameset.h src/plot.h src/plot3d.h src/skyframe.h src/specframe.h src/dsbspecframe.h src/region.h src/box.h src/circle.h src/cmpregion.h src/ellipse.h src/interval.h src/moc.h src/nullregion.h src/pointlist.h src/polygon.h src/prism.h src/stc.h src/stcresourceprofile.h src/stcsearchlocation.h src/stccatalogentrylocation.h src/stcobsdatalocation.h src/timeframe.h src/channel.h src/yamlchan.h src/fitschan.h src/mocchan.h src/stcschan.h src/xmlchan.h >ast.h /bin/bash ./libtool --tag=CC --mode=link gcc -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -Wl,-z,now -o astbad src/astbad.o -lpthread /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_err.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_err_la-err_null.lo -lpthread libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_pgplot.c -fPIC -DPIC -o src/.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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf3d_pgplot.c -fPIC -DPIC -o src/.libs/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_grf3d.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_grf3d_la-grf3d.lo -lpthread libtool: link: gcc -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -Wl,-z -Wl,now -o astbad src/astbad.o -lpthread libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_err_la-err_null.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_err.so.9 -o .libs/libstarlink_ast_err.so.9.2.10 /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_grf_2.0.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_grf_2_0_la-grf_2.0.lo -lpthread /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_grf_3.2.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_grf_3_2_la-grf_3.2.lo -lpthread libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so.9" && ln -s "libstarlink_ast_err.so.9.2.10" "libstarlink_ast_err.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so" && ln -s "libstarlink_ast_err.so.9.2.10" "libstarlink_ast_err.so") libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_grf3d_la-grf3d.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_grf3d.so.9 -o .libs/libstarlink_ast_grf3d.so.9.2.10 libtool: link: ar cr .libs/libstarlink_ast_err.a src/libstarlink_ast_err_la-err_null.o libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so.9" && ln -s "libstarlink_ast_grf3d.so.9.2.10" "libstarlink_ast_grf3d.so.9") libtool: link: ranlib .libs/libstarlink_ast_err.a libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so" && ln -s "libstarlink_ast_grf3d.so.9.2.10" "libstarlink_ast_grf3d.so") libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_err.la" && ln -s "../libstarlink_ast_err.la" "libstarlink_ast_err.la" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_grf_5.6.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_grf_5_6_la-grf_5.6.lo -lpthread libtool: link: ar cr .libs/libstarlink_ast_grf3d.a src/libstarlink_ast_grf3d_la-grf3d.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/tpn.c -fPIC -DPIC -o wcslib/libstarlink_ast_la-tpn.o >/dev/null 2>&1 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" ) 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 libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_grf_2_0_la-grf_2.0.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_grf_2.0.so.9 -o .libs/libstarlink_ast_grf_2.0.so.9.2.10 libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_grf_3_2_la-grf_3.2.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_grf_3.2.so.9 -o .libs/libstarlink_ast_grf_3.2.so.9.2.10 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so.9" && ln -s "libstarlink_ast_grf_2.0.so.9.2.10" "libstarlink_ast_grf_2.0.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so.9" && ln -s "libstarlink_ast_grf_3.2.so.9.2.10" "libstarlink_ast_grf_3.2.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so" && ln -s "libstarlink_ast_grf_2.0.so.9.2.10" "libstarlink_ast_grf_2.0.so") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so" && ln -s "libstarlink_ast_grf_3.2.so.9.2.10" "libstarlink_ast_grf_3.2.so") libtool: link: ar cr .libs/libstarlink_ast_grf_2.0.a src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf_pgplot.c -fPIC -DPIC -o src/libstarlink_ast_pgplot_la-grf_pgplot.o >/dev/null 2>&1 libtool: link: ranlib .libs/libstarlink_ast_grf_2.0.a libtool: link: ar cr .libs/libstarlink_ast_grf_3.2.a src/libstarlink_ast_grf_3_2_la-grf_3.2.o libtool: link: ranlib .libs/libstarlink_ast_grf_3.2.a 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" ) libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_grf_5_6_la-grf_5.6.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_grf_5.6.so.9 -o .libs/libstarlink_ast_grf_5.6.so.9.2.10 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" ) libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_5.6.so.9" && ln -s "libstarlink_ast_grf_5.6.so.9.2.10" "libstarlink_ast_grf_5.6.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_5.6.so" && ln -s "libstarlink_ast_grf_5.6.so.9.2.10" "libstarlink_ast_grf_5.6.so") libtool: link: ar cr .libs/libstarlink_ast_grf_5.6.a src/libstarlink_ast_grf_5_6_la-grf_5.6.o 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" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_pgplot.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_pgplot_la-grf_pgplot.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_pgplot_la-grf_pgplot.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_pgplot.so.9 -o .libs/libstarlink_ast_pgplot.so.9.2.10 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so.9" && ln -s "libstarlink_ast_pgplot.so.9.2.10" "libstarlink_ast_pgplot.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so" && ln -s "libstarlink_ast_pgplot.so.9.2.10" "libstarlink_ast_pgplot.so") libtool: link: ar cr .libs/libstarlink_ast_pgplot.a src/libstarlink_ast_pgplot_la-grf_pgplot.o libtool: link: ranlib .libs/libstarlink_ast_pgplot.a libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grf3d_pgplot.c -fPIC -DPIC -o src/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o >/dev/null 2>&1 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 -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/proj.c -fPIC -DPIC -o wcslib/libstarlink_ast_la-proj.o >/dev/null 2>&1 /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast_pgplot3d.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_pgplot3d_la-grf3d_pgplot.lo -lpthread libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast_pgplot3d.so.9 -o .libs/libstarlink_ast_pgplot3d.so.9.2.10 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so.9" && ln -s "libstarlink_ast_pgplot3d.so.9.2.10" "libstarlink_ast_pgplot3d.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so" && ln -s "libstarlink_ast_pgplot3d.so.9.2.10" "libstarlink_ast_pgplot3d.so") libtool: link: ar cr .libs/libstarlink_ast_pgplot3d.a src/libstarlink_ast_pgplot3d_la-grf3d_pgplot.o 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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/polygon.c -fPIC -DPIC -o src/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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mapping.c -fPIC -DPIC -o src/libstarlink_ast_la-mapping.o >/dev/null 2>&1 /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -DTHREAD_SAFE -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:10:2 -Wl,-z,relro -Wl,-z,now -o libstarlink_ast.la -rpath /usr/lib/i386-linux-gnu src/libstarlink_ast_la-yamlchan.lo src/libstarlink_ast_la-axis.lo src/libstarlink_ast_la-box.lo src/libstarlink_ast_la-channel.lo src/libstarlink_ast_la-chebymap.lo src/libstarlink_ast_la-circle.lo src/libstarlink_ast_la-cmpframe.lo src/libstarlink_ast_la-cmpmap.lo src/libstarlink_ast_la-cmpregion.lo src/libstarlink_ast_la-dsbspecframe.lo src/libstarlink_ast_la-dssmap.lo src/libstarlink_ast_la-ellipse.lo src/libstarlink_ast_la-error.lo src/libstarlink_ast_la-fitschan.lo src/libstarlink_ast_la-fitstable.lo src/libstarlink_ast_la-fluxframe.lo src/libstarlink_ast_la-frame.lo src/libstarlink_ast_la-frameset.lo src/libstarlink_ast_la-globals.lo src/libstarlink_ast_la-grismmap.lo src/libstarlink_ast_la-interval.lo src/libstarlink_ast_la-intramap.lo src/libstarlink_ast_la-keymap.lo src/libstarlink_ast_la-loader.lo src/libstarlink_ast_la-lutmap.lo src/libstarlink_ast_la-mapping.lo src/libstarlink_ast_la-mathmap.lo src/libstarlink_ast_la-matrixmap.lo src/libstarlink_ast_la-memory.lo src/libstarlink_ast_la-moc.lo src/libstarlink_ast_la-mocchan.lo src/libstarlink_ast_la-normmap.lo src/libstarlink_ast_la-nullregion.lo src/libstarlink_ast_la-object.lo src/libstarlink_ast_la-pcdmap.lo src/libstarlink_ast_la-permmap.lo src/libstarlink_ast_la-plot.lo src/libstarlink_ast_la-plot3d.lo src/libstarlink_ast_la-pointlist.lo src/libstarlink_ast_la-pointset.lo src/libstarlink_ast_la-polygon.lo src/libstarlink_ast_la-polymap.lo src/libstarlink_ast_la-prism.lo src/libstarlink_ast_la-ratemap.lo src/libstarlink_ast_la-region.lo src/libstarlink_ast_la-selectormap.lo src/libstarlink_ast_la-shiftmap.lo src/libstarlink_ast_la-skyaxis.lo src/libstarlink_ast_la-skyframe.lo src/libstarlink_ast_la-slamap.lo src/libstarlink_ast_la-specfluxframe.lo src/libstarlink_ast_la-specframe.lo src/libstarlink_ast_la-specmap.lo src/libstarlink_ast_la-sphmap.lo src/libstarlink_ast_la-stc.lo src/libstarlink_ast_la-stccatalogentrylocation.lo src/libstarlink_ast_la-stcobsdatalocation.lo src/libstarlink_ast_la-stcresourceprofile.lo src/libstarlink_ast_la-stcschan.lo src/libstarlink_ast_la-stcsearchlocation.lo src/libstarlink_ast_la-switchmap.lo src/libstarlink_ast_la-table.lo src/libstarlink_ast_la-timeframe.lo src/libstarlink_ast_la-timemap.lo src/libstarlink_ast_la-tranmap.lo src/libstarlink_ast_la-unit.lo src/libstarlink_ast_la-unitmap.lo src/libstarlink_ast_la-unitnormmap.lo src/libstarlink_ast_la-wcsmap.lo src/libstarlink_ast_la-winmap.lo src/libstarlink_ast_la-xml.lo src/libstarlink_ast_la-xmlchan.lo src/libstarlink_ast_la-xphmap.lo src/libstarlink_ast_la-zoommap.lo src/libstarlink_ast_la-fyamlchan.lo src/libstarlink_ast_la-c2f77.lo src/libstarlink_ast_la-fbox.lo src/libstarlink_ast_la-fchannel.lo src/libstarlink_ast_la-fchebymap.lo src/libstarlink_ast_la-fcircle.lo src/libstarlink_ast_la-fcmpframe.lo src/libstarlink_ast_la-fcmpmap.lo src/libstarlink_ast_la-fcmpregion.lo src/libstarlink_ast_la-fdsbspecframe.lo src/libstarlink_ast_la-fdssmap.lo src/libstarlink_ast_la-fellipse.lo src/libstarlink_ast_la-ferror.lo src/libstarlink_ast_la-ffitschan.lo src/libstarlink_ast_la-ffitstable.lo src/libstarlink_ast_la-ffluxframe.lo src/libstarlink_ast_la-fframe.lo src/libstarlink_ast_la-fframeset.lo src/libstarlink_ast_la-fgrismmap.lo src/libstarlink_ast_la-finterval.lo src/libstarlink_ast_la-fintramap.lo src/libstarlink_ast_la-fkeymap.lo src/libstarlink_ast_la-flutmap.lo src/libstarlink_ast_la-fmapping.lo src/libstarlink_ast_la-fmathmap.lo src/libstarlink_ast_la-fmatrixmap.lo src/libstarlink_ast_la-fmoc.lo src/libstarlink_ast_la-fmocchan.lo src/libstarlink_ast_la-fnormmap.lo src/libstarlink_ast_la-fnullregion.lo src/libstarlink_ast_la-fobject.lo src/libstarlink_ast_la-fpcdmap.lo src/libstarlink_ast_la-fpermmap.lo src/libstarlink_ast_la-fplot.lo src/libstarlink_ast_la-fplot3d.lo src/libstarlink_ast_la-fpointlist.lo src/libstarlink_ast_la-fpolygon.lo src/libstarlink_ast_la-fpolymap.lo src/libstarlink_ast_la-fprism.lo src/libstarlink_ast_la-fratemap.lo src/libstarlink_ast_la-fregion.lo src/libstarlink_ast_la-fselectormap.lo src/libstarlink_ast_la-fshiftmap.lo src/libstarlink_ast_la-fskyframe.lo src/libstarlink_ast_la-fslamap.lo src/libstarlink_ast_la-fspecfluxframe.lo src/libstarlink_ast_la-fspecframe.lo src/libstarlink_ast_la-fspecmap.lo src/libstarlink_ast_la-fsphmap.lo src/libstarlink_ast_la-fstc.lo src/libstarlink_ast_la-fstccatalogentrylocation.lo src/libstarlink_ast_la-fstcobsdatalocation.lo src/libstarlink_ast_la-fstcresourceprofile.lo src/libstarlink_ast_la-fstcschan.lo src/libstarlink_ast_la-fstcsearchlocation.lo src/libstarlink_ast_la-fswitchmap.lo src/libstarlink_ast_la-ftable.lo src/libstarlink_ast_la-ftimeframe.lo src/libstarlink_ast_la-ftimemap.lo src/libstarlink_ast_la-ftranmap.lo src/libstarlink_ast_la-funitmap.lo src/libstarlink_ast_la-funitnormmap.lo src/libstarlink_ast_la-fwcsmap.lo src/libstarlink_ast_la-fwinmap.lo src/libstarlink_ast_la-fxmlchan.lo src/libstarlink_ast_la-fzoommap.lo wcslib/libstarlink_ast_la-proj.lo wcslib/libstarlink_ast_la-tpn.lo wcslib/libstarlink_ast_la-wcstrig.lo -lstarlink_pal -lerfa -lcminpack -lpthread libtool: link: gcc -shared -fPIC -DPIC src/.libs/libstarlink_ast_la-yamlchan.o src/.libs/libstarlink_ast_la-axis.o src/.libs/libstarlink_ast_la-box.o src/.libs/libstarlink_ast_la-channel.o src/.libs/libstarlink_ast_la-chebymap.o src/.libs/libstarlink_ast_la-circle.o src/.libs/libstarlink_ast_la-cmpframe.o src/.libs/libstarlink_ast_la-cmpmap.o src/.libs/libstarlink_ast_la-cmpregion.o src/.libs/libstarlink_ast_la-dsbspecframe.o src/.libs/libstarlink_ast_la-dssmap.o src/.libs/libstarlink_ast_la-ellipse.o src/.libs/libstarlink_ast_la-error.o src/.libs/libstarlink_ast_la-fitschan.o src/.libs/libstarlink_ast_la-fitstable.o src/.libs/libstarlink_ast_la-fluxframe.o src/.libs/libstarlink_ast_la-frame.o src/.libs/libstarlink_ast_la-frameset.o src/.libs/libstarlink_ast_la-globals.o src/.libs/libstarlink_ast_la-grismmap.o src/.libs/libstarlink_ast_la-interval.o src/.libs/libstarlink_ast_la-intramap.o src/.libs/libstarlink_ast_la-keymap.o src/.libs/libstarlink_ast_la-loader.o src/.libs/libstarlink_ast_la-lutmap.o src/.libs/libstarlink_ast_la-mapping.o src/.libs/libstarlink_ast_la-mathmap.o src/.libs/libstarlink_ast_la-matrixmap.o src/.libs/libstarlink_ast_la-memory.o src/.libs/libstarlink_ast_la-moc.o src/.libs/libstarlink_ast_la-mocchan.o src/.libs/libstarlink_ast_la-normmap.o src/.libs/libstarlink_ast_la-nullregion.o src/.libs/libstarlink_ast_la-object.o src/.libs/libstarlink_ast_la-pcdmap.o src/.libs/libstarlink_ast_la-permmap.o src/.libs/libstarlink_ast_la-plot.o src/.libs/libstarlink_ast_la-plot3d.o src/.libs/libstarlink_ast_la-pointlist.o src/.libs/libstarlink_ast_la-pointset.o src/.libs/libstarlink_ast_la-polygon.o src/.libs/libstarlink_ast_la-polymap.o src/.libs/libstarlink_ast_la-prism.o src/.libs/libstarlink_ast_la-ratemap.o src/.libs/libstarlink_ast_la-region.o src/.libs/libstarlink_ast_la-selectormap.o src/.libs/libstarlink_ast_la-shiftmap.o src/.libs/libstarlink_ast_la-skyaxis.o src/.libs/libstarlink_ast_la-skyframe.o src/.libs/libstarlink_ast_la-slamap.o src/.libs/libstarlink_ast_la-specfluxframe.o src/.libs/libstarlink_ast_la-specframe.o src/.libs/libstarlink_ast_la-specmap.o src/.libs/libstarlink_ast_la-sphmap.o src/.libs/libstarlink_ast_la-stc.o src/.libs/libstarlink_ast_la-stccatalogentrylocation.o src/.libs/libstarlink_ast_la-stcobsdatalocation.o src/.libs/libstarlink_ast_la-stcresourceprofile.o src/.libs/libstarlink_ast_la-stcschan.o src/.libs/libstarlink_ast_la-stcsearchlocation.o src/.libs/libstarlink_ast_la-switchmap.o src/.libs/libstarlink_ast_la-table.o src/.libs/libstarlink_ast_la-timeframe.o src/.libs/libstarlink_ast_la-timemap.o src/.libs/libstarlink_ast_la-tranmap.o src/.libs/libstarlink_ast_la-unit.o src/.libs/libstarlink_ast_la-unitmap.o src/.libs/libstarlink_ast_la-unitnormmap.o src/.libs/libstarlink_ast_la-wcsmap.o src/.libs/libstarlink_ast_la-winmap.o src/.libs/libstarlink_ast_la-xml.o src/.libs/libstarlink_ast_la-xmlchan.o src/.libs/libstarlink_ast_la-xphmap.o src/.libs/libstarlink_ast_la-zoommap.o src/.libs/libstarlink_ast_la-fyamlchan.o src/.libs/libstarlink_ast_la-c2f77.o src/.libs/libstarlink_ast_la-fbox.o src/.libs/libstarlink_ast_la-fchannel.o src/.libs/libstarlink_ast_la-fchebymap.o src/.libs/libstarlink_ast_la-fcircle.o src/.libs/libstarlink_ast_la-fcmpframe.o src/.libs/libstarlink_ast_la-fcmpmap.o src/.libs/libstarlink_ast_la-fcmpregion.o src/.libs/libstarlink_ast_la-fdsbspecframe.o src/.libs/libstarlink_ast_la-fdssmap.o src/.libs/libstarlink_ast_la-fellipse.o src/.libs/libstarlink_ast_la-ferror.o src/.libs/libstarlink_ast_la-ffitschan.o src/.libs/libstarlink_ast_la-ffitstable.o src/.libs/libstarlink_ast_la-ffluxframe.o src/.libs/libstarlink_ast_la-fframe.o src/.libs/libstarlink_ast_la-fframeset.o src/.libs/libstarlink_ast_la-fgrismmap.o src/.libs/libstarlink_ast_la-finterval.o src/.libs/libstarlink_ast_la-fintramap.o src/.libs/libstarlink_ast_la-fkeymap.o src/.libs/libstarlink_ast_la-flutmap.o src/.libs/libstarlink_ast_la-fmapping.o src/.libs/libstarlink_ast_la-fmathmap.o src/.libs/libstarlink_ast_la-fmatrixmap.o src/.libs/libstarlink_ast_la-fmoc.o src/.libs/libstarlink_ast_la-fmocchan.o src/.libs/libstarlink_ast_la-fnormmap.o src/.libs/libstarlink_ast_la-fnullregion.o src/.libs/libstarlink_ast_la-fobject.o src/.libs/libstarlink_ast_la-fpcdmap.o src/.libs/libstarlink_ast_la-fpermmap.o src/.libs/libstarlink_ast_la-fplot.o src/.libs/libstarlink_ast_la-fplot3d.o src/.libs/libstarlink_ast_la-fpointlist.o src/.libs/libstarlink_ast_la-fpolygon.o src/.libs/libstarlink_ast_la-fpolymap.o src/.libs/libstarlink_ast_la-fprism.o src/.libs/libstarlink_ast_la-fratemap.o src/.libs/libstarlink_ast_la-fregion.o src/.libs/libstarlink_ast_la-fselectormap.o src/.libs/libstarlink_ast_la-fshiftmap.o src/.libs/libstarlink_ast_la-fskyframe.o src/.libs/libstarlink_ast_la-fslamap.o src/.libs/libstarlink_ast_la-fspecfluxframe.o src/.libs/libstarlink_ast_la-fspecframe.o src/.libs/libstarlink_ast_la-fspecmap.o src/.libs/libstarlink_ast_la-fsphmap.o src/.libs/libstarlink_ast_la-fstc.o src/.libs/libstarlink_ast_la-fstccatalogentrylocation.o src/.libs/libstarlink_ast_la-fstcobsdatalocation.o src/.libs/libstarlink_ast_la-fstcresourceprofile.o src/.libs/libstarlink_ast_la-fstcschan.o src/.libs/libstarlink_ast_la-fstcsearchlocation.o src/.libs/libstarlink_ast_la-fswitchmap.o src/.libs/libstarlink_ast_la-ftable.o src/.libs/libstarlink_ast_la-ftimeframe.o src/.libs/libstarlink_ast_la-ftimemap.o src/.libs/libstarlink_ast_la-ftranmap.o src/.libs/libstarlink_ast_la-funitmap.o src/.libs/libstarlink_ast_la-funitnormmap.o src/.libs/libstarlink_ast_la-fwcsmap.o src/.libs/libstarlink_ast_la-fwinmap.o src/.libs/libstarlink_ast_la-fxmlchan.o src/.libs/libstarlink_ast_la-fzoommap.o wcslib/.libs/libstarlink_ast_la-proj.o wcslib/.libs/libstarlink_ast_la-tpn.o wcslib/.libs/libstarlink_ast_la-wcstrig.o -lstarlink_pal -lerfa -lcminpack -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-z -Wl,now -Wl,-soname -Wl,libstarlink_ast.so.9 -o .libs/libstarlink_ast.so.9.2.10 libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so.9" && ln -s "libstarlink_ast.so.9.2.10" "libstarlink_ast.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so" && ln -s "libstarlink_ast.so.9.2.10" "libstarlink_ast.so") libtool: link: ar cr .libs/libstarlink_ast.a src/libstarlink_ast_la-yamlchan.o src/libstarlink_ast_la-axis.o src/libstarlink_ast_la-box.o src/libstarlink_ast_la-channel.o src/libstarlink_ast_la-chebymap.o src/libstarlink_ast_la-circle.o src/libstarlink_ast_la-cmpframe.o src/libstarlink_ast_la-cmpmap.o src/libstarlink_ast_la-cmpregion.o src/libstarlink_ast_la-dsbspecframe.o src/libstarlink_ast_la-dssmap.o src/libstarlink_ast_la-ellipse.o src/libstarlink_ast_la-error.o src/libstarlink_ast_la-fitschan.o src/libstarlink_ast_la-fitstable.o src/libstarlink_ast_la-fluxframe.o src/libstarlink_ast_la-frame.o src/libstarlink_ast_la-frameset.o src/libstarlink_ast_la-globals.o src/libstarlink_ast_la-grismmap.o src/libstarlink_ast_la-interval.o src/libstarlink_ast_la-intramap.o src/libstarlink_ast_la-keymap.o src/libstarlink_ast_la-loader.o src/libstarlink_ast_la-lutmap.o src/libstarlink_ast_la-mapping.o src/libstarlink_ast_la-mathmap.o src/libstarlink_ast_la-matrixmap.o src/libstarlink_ast_la-memory.o src/libstarlink_ast_la-moc.o src/libstarlink_ast_la-mocchan.o src/libstarlink_ast_la-normmap.o src/libstarlink_ast_la-nullregion.o src/libstarlink_ast_la-object.o src/libstarlink_ast_la-pcdmap.o src/libstarlink_ast_la-permmap.o src/libstarlink_ast_la-plot.o src/libstarlink_ast_la-plot3d.o src/libstarlink_ast_la-pointlist.o src/libstarlink_ast_la-pointset.o src/libstarlink_ast_la-polygon.o src/libstarlink_ast_la-polymap.o src/libstarlink_ast_la-prism.o src/libstarlink_ast_la-ratemap.o src/libstarlink_ast_la-region.o src/libstarlink_ast_la-selectormap.o src/libstarlink_ast_la-shiftmap.o src/libstarlink_ast_la-skyaxis.o src/libstarlink_ast_la-skyframe.o src/libstarlink_ast_la-slamap.o src/libstarlink_ast_la-specfluxframe.o src/libstarlink_ast_la-specframe.o src/libstarlink_ast_la-specmap.o src/libstarlink_ast_la-sphmap.o src/libstarlink_ast_la-stc.o src/libstarlink_ast_la-stccatalogentrylocation.o src/libstarlink_ast_la-stcobsdatalocation.o src/libstarlink_ast_la-stcresourceprofile.o src/libstarlink_ast_la-stcschan.o src/libstarlink_ast_la-stcsearchlocation.o src/libstarlink_ast_la-switchmap.o src/libstarlink_ast_la-table.o src/libstarlink_ast_la-timeframe.o src/libstarlink_ast_la-timemap.o src/libstarlink_ast_la-tranmap.o src/libstarlink_ast_la-unit.o src/libstarlink_ast_la-unitmap.o src/libstarlink_ast_la-unitnormmap.o src/libstarlink_ast_la-wcsmap.o src/libstarlink_ast_la-winmap.o src/libstarlink_ast_la-xml.o src/libstarlink_ast_la-xmlchan.o src/libstarlink_ast_la-xphmap.o src/libstarlink_ast_la-zoommap.o src/libstarlink_ast_la-fyamlchan.o src/libstarlink_ast_la-c2f77.o src/libstarlink_ast_la-fbox.o src/libstarlink_ast_la-fchannel.o src/libstarlink_ast_la-fchebymap.o src/libstarlink_ast_la-fcircle.o src/libstarlink_ast_la-fcmpframe.o src/libstarlink_ast_la-fcmpmap.o src/libstarlink_ast_la-fcmpregion.o src/libstarlink_ast_la-fdsbspecframe.o src/libstarlink_ast_la-fdssmap.o src/libstarlink_ast_la-fellipse.o src/libstarlink_ast_la-ferror.o src/libstarlink_ast_la-ffitschan.o src/libstarlink_ast_la-ffitstable.o src/libstarlink_ast_la-ffluxframe.o src/libstarlink_ast_la-fframe.o src/libstarlink_ast_la-fframeset.o src/libstarlink_ast_la-fgrismmap.o src/libstarlink_ast_la-finterval.o src/libstarlink_ast_la-fintramap.o src/libstarlink_ast_la-fkeymap.o src/libstarlink_ast_la-flutmap.o src/libstarlink_ast_la-fmapping.o src/libstarlink_ast_la-fmathmap.o src/libstarlink_ast_la-fmatrixmap.o src/libstarlink_ast_la-fmoc.o src/libstarlink_ast_la-fmocchan.o src/libstarlink_ast_la-fnormmap.o src/libstarlink_ast_la-fnullregion.o src/libstarlink_ast_la-fobject.o src/libstarlink_ast_la-fpcdmap.o src/libstarlink_ast_la-fpermmap.o src/libstarlink_ast_la-fplot.o src/libstarlink_ast_la-fplot3d.o src/libstarlink_ast_la-fpointlist.o src/libstarlink_ast_la-fpolygon.o src/libstarlink_ast_la-fpolymap.o src/libstarlink_ast_la-fprism.o src/libstarlink_ast_la-fratemap.o src/libstarlink_ast_la-fregion.o src/libstarlink_ast_la-fselectormap.o src/libstarlink_ast_la-fshiftmap.o src/libstarlink_ast_la-fskyframe.o src/libstarlink_ast_la-fslamap.o src/libstarlink_ast_la-fspecfluxframe.o src/libstarlink_ast_la-fspecframe.o src/libstarlink_ast_la-fspecmap.o src/libstarlink_ast_la-fsphmap.o src/libstarlink_ast_la-fstc.o src/libstarlink_ast_la-fstccatalogentrylocation.o src/libstarlink_ast_la-fstcobsdatalocation.o src/libstarlink_ast_la-fstcresourceprofile.o src/libstarlink_ast_la-fstcschan.o src/libstarlink_ast_la-fstcsearchlocation.o src/libstarlink_ast_la-fswitchmap.o src/libstarlink_ast_la-ftable.o src/libstarlink_ast_la-ftimeframe.o src/libstarlink_ast_la-ftimemap.o src/libstarlink_ast_la-ftranmap.o src/libstarlink_ast_la-funitmap.o src/libstarlink_ast_la-funitnormmap.o src/libstarlink_ast_la-fwcsmap.o src/libstarlink_ast_la-fwinmap.o src/libstarlink_ast_la-fxmlchan.o src/libstarlink_ast_la-fzoommap.o wcslib/libstarlink_ast_la-proj.o wcslib/libstarlink_ast_la-tpn.o wcslib/libstarlink_ast_la-wcstrig.o 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/reproducible-path/starlink-ast-9.2.10+dfsg' make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_auto_test make -j11 check "TESTSUITEFLAGS=-j11 --verbose" VERBOSE=1 make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make check-am make[2]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make ast_test make[3]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c -o ast_test.o ast_test.c /bin/bash ./libtool --tag=CC --mode=link gcc -g -O2 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -Wl,-z,now -o ast_test ast_test.o -lstarlink_pal -lcminpack 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 -Werror=implicit-function-declaration -ffile-prefix-map=/build/reproducible-path/starlink-ast-9.2.10+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -Wl,-z -Wl,now -o .libs/ast_test ast_test.o -lstarlink_pal -lcminpack ./.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/reproducible-path/starlink-ast-9.2.10+dfsg' make check-TESTS make[3]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[4]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' PASS: ast_test ============================================================================ Testsuite summary for ast 9.2.10 ============================================================================ # TOTAL: 1 # PASS: 1 # SKIP: 0 # XFAIL: 0 # FAIL: 0 # XPASS: 0 # ERROR: 0 ============================================================================ make[4]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[3]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[2]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' create-stamp debian/debhelper-build-stamp dh_prep dh_installdirs dh_auto_install make -j1 install DESTDIR=/build/reproducible-path/starlink-ast-9.2.10\+dfsg/debian/tmp AM_UPDATE_INFO_DIR=no make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make install-am make[2]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[3]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/bin' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link_adam '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/bin' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu' /bin/bash ./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/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu' libtool: install: /usr/bin/install -c .libs/libstarlink_ast.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast.so.9.2.10 libstarlink_ast.so.9 || { rm -f libstarlink_ast.so.9 && ln -s libstarlink_ast.so.9.2.10 libstarlink_ast.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast.so.9.2.10 libstarlink_ast.so || { rm -f libstarlink_ast.so && ln -s libstarlink_ast.so.9.2.10 libstarlink_ast.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_err.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_err.so.9.2.10 libstarlink_ast_err.so.9 || { rm -f libstarlink_ast_err.so.9 && ln -s libstarlink_ast_err.so.9.2.10 libstarlink_ast_err.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_err.so.9.2.10 libstarlink_ast_err.so || { rm -f libstarlink_ast_err.so && ln -s libstarlink_ast_err.so.9.2.10 libstarlink_ast_err.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_err.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.9.2.10 libstarlink_ast_grf3d.so.9 || { rm -f libstarlink_ast_grf3d.so.9 && ln -s libstarlink_ast_grf3d.so.9.2.10 libstarlink_ast_grf3d.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.9.2.10 libstarlink_ast_grf3d.so || { rm -f libstarlink_ast_grf3d.so && ln -s libstarlink_ast_grf3d.so.9.2.10 libstarlink_ast_grf3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.9.2.10 libstarlink_ast_grf_2.0.so.9 || { rm -f libstarlink_ast_grf_2.0.so.9 && ln -s libstarlink_ast_grf_2.0.so.9.2.10 libstarlink_ast_grf_2.0.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.9.2.10 libstarlink_ast_grf_2.0.so || { rm -f libstarlink_ast_grf_2.0.so && ln -s libstarlink_ast_grf_2.0.so.9.2.10 libstarlink_ast_grf_2.0.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.9.2.10 libstarlink_ast_grf_3.2.so.9 || { rm -f libstarlink_ast_grf_3.2.so.9 && ln -s libstarlink_ast_grf_3.2.so.9.2.10 libstarlink_ast_grf_3.2.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.9.2.10 libstarlink_ast_grf_3.2.so || { rm -f libstarlink_ast_grf_3.2.so && ln -s libstarlink_ast_grf_3.2.so.9.2.10 libstarlink_ast_grf_3.2.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.9.2.10 libstarlink_ast_grf_5.6.so.9 || { rm -f libstarlink_ast_grf_5.6.so.9 && ln -s libstarlink_ast_grf_5.6.so.9.2.10 libstarlink_ast_grf_5.6.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.9.2.10 libstarlink_ast_grf_5.6.so || { rm -f libstarlink_ast_grf_5.6.so && ln -s libstarlink_ast_grf_5.6.so.9.2.10 libstarlink_ast_grf_5.6.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.9.2.10 libstarlink_ast_pgplot.so.9 || { rm -f libstarlink_ast_pgplot.so.9 && ln -s libstarlink_ast_pgplot.so.9.2.10 libstarlink_ast_pgplot.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.9.2.10 libstarlink_ast_pgplot.so || { rm -f libstarlink_ast_pgplot.so && ln -s libstarlink_ast_pgplot.so.9.2.10 libstarlink_ast_pgplot.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.so.9.2.10 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.so.9.2.10 libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.9.2.10 libstarlink_ast_pgplot3d.so.9 || { rm -f libstarlink_ast_pgplot3d.so.9 && ln -s libstarlink_ast_pgplot3d.so.9.2.10 libstarlink_ast_pgplot3d.so.9; }; }) libtool: install: (cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.9.2.10 libstarlink_ast_pgplot3d.so || { rm -f libstarlink_ast_pgplot3d.so && ln -s libstarlink_ast_pgplot3d.so.9.2.10 libstarlink_ast_pgplot3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.lai /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_err.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_err.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_err.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.a /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: chmod 644 /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: ranlib /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.a libtool: warning: remember to run 'libtool --finish /usr/lib/i386-linux-gnu' make install-exec-hook make[4]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' /usr/bin/mkdir -p /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu cd /build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-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/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-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/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pass2.a MANIFEST:/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pass2.la MANIFEST:/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pass2.so MANIFEST:/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pass2.so.9 MANIFEST:/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/lib/i386-linux-gnu/libstarlink_ast_pass2.so.9.2.10 make[4]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include/star' /usr/bin/install -c -m 644 GRF_PAR src/grf.h src/grf3d.h '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include/star' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 GRF_PAR src/grf.h src/grf3d.h '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include/star' /usr/bin/install -c -m 644 ast.h AST_PAR '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include/star' /usr/bin/mkdir -p '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 ast.h AST_PAR '/build/reproducible-path/starlink-ast-9.2.10+dfsg/debian/tmp/usr/include' make[3]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[2]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_install debian/rules override_dh_installdocs-indep make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' make doc make[2]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' pdflatex sun211.tex && pdflatex sun211.tex This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2025/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2024-11-01> L3 programming layer <2024-11-02> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2024/06/29 v1.4n Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size11.clo)) ..........Article!.......... (/usr/share/texlive/texmf-dist/tex/generic/iftex/ifpdf.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty) (/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/etoolbox/etoolbox.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/translations/translations.sty (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/infwarerr/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty))) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.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) Package xcolor Warning: Package option `usenames' is obsolete and ignored on in put line 265. (/usr/share/texlive/texmf-dist/tex/latex/graphics/mathcolor.ltx)) (/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/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/latex/kvsetkeys/kvsetkeys.sty)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/zref/zref-abspage.sty (/usr/share/texlive/texmf-dist/tex/latex/zref/zref-base.sty (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/etexcmds/etexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/auxhook/auxhook.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-latex.def) (/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/pgfkeyslibraryfiltered .code.tex)) (/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/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/pgfmathcalc.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfint.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/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/pdflscape/pdflscape.sty (/usr/share/texlive/texmf-dist/tex/latex/pdflscape/pdflscape-nometadata.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/lscape.sty))) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/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/pdfescape/pdfescape.sty) (/usr/share/texlive/texmf-dist/tex/latex/hycolor/hycolor.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (/usr/share/texlive/texmf-dist/tex/generic/stringenc/stringenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/generic/intcalc/intcalc.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/puenc.def) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/latex/base/atveryend-ltx.sty) (/usr/share/texlive/texmf-dist/tex/generic/uniquecounter/uniquecounter.sty (/usr/share/texlive/texmf-dist/tex/generic/bigintcalc/bigintcalc.sty)))) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty) (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/atbegshi-ltx.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty) (/usr/share/texmf/tex/latex/html/html.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) (./sst.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) No file sun211.aux. (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/translations/translations-basic-dictio nary-english.trsl) (/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/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) *geometry* driver: auto-detecting *geometry* detected driver: pdftex Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}{/usr/share/texlive/texmf- dist/fonts/enc/dvips/base/8r.enc} <./sun211_figures/fronta.pdf> <./sun211_figur es/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 >] (/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) [2] No file sun211.toc. [3] No file sun211.lof. [4] [1] LaTeX Warning: Hyper reference `System' on page 2 undefined on input line 146. (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ts1ppl.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.47258pt 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 `YamlChan' on page 12 undefined on input line 56 3. LaTeX Warning: Hyper reference `StcsChan' on page 12 undefined on input line 56 7. LaTeX Warning: Hyper reference `Region' on page 12 undefined on input line 573. LaTeX Warning: Reference `ss:channels' on page 12 undefined on input line 576. LaTeX Warning: Reference `ss:nativefits' on page 12 undefined on input line 576 . LaTeX Warning: Reference `ss:foreignfits' on page 12 undefined on input line 57 7. LaTeX Warning: Reference `ss:classdescriptions' on page 12 undefined on input l ine 578. LaTeX Warning: Hyper reference `Encoding' on page 12 undefined on input line 57 8. LaTeX Warning: Reference `ss:attributedescriptions' on page 12 undefined on inp ut line 579. LaTeX Warning: Hyper reference `FrameSet' on page 12 undefined on input line 58 4. LaTeX Warning: Hyper reference `Plot' on page 12 undefined on input line 585. LaTeX Warning: Hyper reference `Frame' on page 12 undefined on input line 585. LaTeX Warning: Hyper reference `Plot3D' on page 12 undefined on input line 590. LaTeX Warning: Hyper reference `CmpFrame' on page 12 undefined on input line 60 9. LaTeX Warning: Reference `fig:gridplot' on page 12 undefined on input line 615. [12] LaTeX Warning: Reference `ss:plots' on page 13 undefined on input line 636. LaTeX Warning: Reference `ss:classdescriptions' on page 13 undefined on input l ine 637. [13 <./sun211_figures/gridplot_bw.pdf>] [14] LaTeX Warning: Reference `ss:primer' on page 15 undefined on input line 653. LaTeX Warning: Hyper reference `astBegin' on page 15 undefined on input line 69 0. LaTeX Warning: Hyper reference `astEnd' on page 15 undefined on input line 690. LaTeX Warning: Reference `ss:contexts' on page 15 undefined on input line 692. LaTeX Warning: Reference `ss:accessingheaderfile' on page 15 undefined on input line 694. [15] LaTeX Warning: Reference `ss:accessingheaderfile' on page 16 undefined on input line 715. LaTeX Warning: Reference `ss:linking' on page 16 undefined on input line 716. LaTeX Warning: Hyper reference `ast_link' on page 16 undefined on input line 71 7. LaTeX Warning: Reference `ss:commanddescriptions' on page 16 undefined on input line 718. LaTeX Warning: Hyper reference `FrameSet' on page 16 undefined on input line 76 7. LaTeX Warning: Hyper reference `Channel' on page 16 undefined on input line 773 . LaTeX Warning: Hyper reference `XmlChan' on page 16 undefined on input line 773 . LaTeX Warning: Reference `ss:channels' on page 16 undefined on input line 774. LaTeX Warning: Hyper reference `FitsChan' on page 16 undefined on input line 77 4. [16] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 17 undefined on i nput line 782. LaTeX Warning: Reference `ss:readingforeignfits' on page 17 undefined on input line 783. LaTeX Warning: Reference `ss:nativefits' on page 17 undefined on input line 785 . LaTeX Warning: Reference `ss:foreignfits' on page 17 undefined on input line 78 5. LaTeX Warning: Reference `ss:framesets' on page 17 undefined on input line 786. LaTeX Warning: Reference `ss:fshigher' on page 17 undefined on input line 786. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 7 91. LaTeX Warning: Reference `ss:errordetection' on page 17 undefined on input line 814. LaTeX Warning: Reference `ss:validatinginput' on page 17 undefined on input lin e 815. LaTeX Warning: Reference `ss:readingforeignfits' on page 17 undefined on input line 816. LaTeX Warning: Hyper reference `Object' on page 17 undefined on input line 820. LaTeX Warning: Hyper reference `FrameSet' on page 17 undefined on input line 82 9. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 8 30. LaTeX Warning: Hyper reference `astShow' on page 17 undefined on input line 833 . LaTeX Warning: Reference `ss:displayingobjects' on page 17 undefined on input l ine 834. LaTeX Warning: Reference `ss:textualoutputformat' on page 17 undefined on input line 835. LaTeX Warning: Hyper reference `FrameSet' on page 17 undefined on input line 83 9. LaTeX Warning: Reference `ss:howtoreadwcs' on page 17 undefined on input line 8 40. [17] LaTeX Warning: Hyper reference `astTran2' on page 18 undefined on input line 86 4. LaTeX Warning: Hyper reference `astTran1' on page 18 undefined on input line 86 6. LaTeX Warning: Hyper reference `astTranN' on page 18 undefined on input line 86 8. LaTeX Warning: Hyper reference `astTranP' on page 18 undefined on input line 86 8. LaTeX Warning: Reference `ss:functiondescriptions' on page 18 undefined on inpu t line 869. LaTeX Warning: Reference `ss:transforming' on page 18 undefined on input line 8 72. LaTeX Warning: Reference `ss:framesetasmapping' on page 18 undefined on input l ine 872. LaTeX Warning: Reference `ss:badcoordinates' on page 18 undefined on input line 874. LaTeX Warning: Reference `ss:howtoreadwcs' on page 18 undefined on input line 8 85. LaTeX Warning: Hyper reference `FrameSet' on page 18 undefined on input line 88 6. LaTeX Warning: Reference `ss:howtotransform' on page 18 undefined on input line 918. LaTeX Warning: Hyper reference `FrameSet' on page 18 undefined on input line 92 0. LaTeX Warning: Reference `ss:howtoreadwcs' on page 18 undefined on input line 9 21. LaTeX Warning: Reference `ss:howtotransform' on page 18 undefined on input line 923. [18] LaTeX Warning: Hyper reference `astFormat' on page 19 undefined on input line 9 40. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 19 undefined on inpu t line 949. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 19 undefined on i nput line 950. LaTeX Warning: Reference `ss:normalising' on page 19 undefined on input line 95 1. LaTeX Warning: Hyper reference `FrameSet' on page 19 undefined on input line 96 2. LaTeX Warning: Reference `ss:howtoreadwcs' on page 19 undefined on input line 9 63. LaTeX Warning: Reference `ss:howtotransform' on page 19 undefined on input line 964. LaTeX Warning: Hyper reference `Report' on page 19 undefined on input line 974. LaTeX Warning: Reference `ss:attributedescriptions' on page 19 undefined on inp ut line 992. LaTeX Warning: Reference `ss:settingattributes' on page 19 undefined on input l ine 993. LaTeX Warning: Reference `ss:gettingattributes' on page 19 undefined on input l ine 994. [19] LaTeX Warning: Reference `ss:howtoformatcoordinates' on page 20 undefined on in put line 999. LaTeX Warning: Hyper reference `FrameSet' on page 20 undefined on input line 10 07. LaTeX Warning: Reference `ss:howtoreadwcs' on page 20 undefined on input line 1 008. [20] LaTeX Warning: Hyper reference `astUnformat' on page 21 undefined on input line 1073. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 21 undefined on in put line 1073. LaTeX Warning: Reference `ss:unformattingskyaxisvalues' on page 21 undefined on input line 1076. LaTeX Warning: Hyper reference `FrameSet' on page 21 undefined on input line 10 86. [21] LaTeX Warning: Hyper reference `FitsChan' on page 22 undefined on input line 11 58. LaTeX Warning: Reference `ss:howtoreadwcs' on page 22 undefined on input line 1 159. LaTeX Warning: Reference `ss:howtowritewcs' on page 22 undefined on input line 1162. LaTeX Warning: Hyper reference `Frame' on page 22 undefined on input line 1168. LaTeX Warning: Hyper reference `SkyFrame' on page 22 undefined on input line 11 71. LaTeX Warning: Hyper reference `SpecFrame' on page 22 undefined on input line 1 171. LaTeX Warning: Hyper reference `CmpFrame' on page 22 undefined on input line 11 72. LaTeX Warning: Hyper reference `Mapping' on page 22 undefined on input line 117 4. [22] LaTeX Warning: Hyper reference `Mapping' on page 23 undefined on input line 119 1. LaTeX Warning: Hyper reference `MatrixMap' on page 23 undefined on input line 1 221. LaTeX Warning: Hyper reference `WinMap' on page 23 undefined on input line 1222 . LaTeX Warning: Hyper reference `ShiftMap' on page 23 undefined on input line 12 24. [23] LaTeX Warning: Reference `ss:mappingselection' on page 24 undefined on input li ne 1259. LaTeX Warning: Reference `ss:classdescriptions' on page 24 undefined on input l ine 1261. LaTeX Warning: Reference `ss:cmpmapoverview' on page 24 undefined on input line 1262. LaTeX Warning: Reference `ss:cmpmaps' on page 24 undefined on input line 1263. LaTeX Warning: Hyper reference `FrameSet' on page 24 undefined on input line 12 66. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 267. LaTeX Warning: Reference `ss:remapframe' on page 24 undefined on input line 129 2. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 24 undefined on inpu t line 1292. LaTeX Warning: Reference `ss:howtomodifywcs' on page 24 undefined on input line 1299. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 303. LaTeX Warning: Reference `ss:howtoreadwcs' on page 24 undefined on input line 1 308. [24] LaTeX Warning: Hyper reference `Encoding' on page 25 undefined on input line 13 42. LaTeX Warning: Reference `ss:howtomodifywcs' on page 25 undefined on input line 1345. LaTeX Warning: Hyper reference `FrameSet' on page 25 undefined on input line 13 46. LaTeX Warning: Hyper reference `FitsChan' on page 25 undefined on input line 13 47. [25] LaTeX Warning: Reference `ss:addressingfitscards' on page 26 undefined on input line 1389. LaTeX Warning: Reference `ss:addingmulticards' on page 26 undefined on input li ne 1389. LaTeX Warning: Reference `ss:addingfitscards' on page 26 undefined on input lin e 1389. LaTeX Warning: Reference `ss:findingandchangingfits' on page 26 undefined on in put line 1390. LaTeX Warning: Hyper reference `Channel' on page 26 undefined on input line 141 2. LaTeX Warning: Hyper reference `XmlChan' on page 26 undefined on input line 141 2. LaTeX Warning: Reference `ss:channels' on page 26 undefined on input line 1413. LaTeX Warning: Reference `ss:propagatingwcsinformation' on page 26 undefined on input line 1421. LaTeX Warning: Reference `ss:writingnativefits' on page 26 undefined on input l ine 1423. LaTeX Warning: Reference `ss:writingforeignfits' on page 26 undefined on input line 1423. LaTeX Warning: Reference `ss:nativeencoding' on page 26 undefined on input line 1425. LaTeX Warning: Reference `ss:foreignencodings' on page 26 undefined on input li ne 1426. LaTeX Warning: Reference `ss:attributedescriptions' on page 26 undefined on inp ut line 1427. LaTeX Warning: Reference `ss:nativefits' on page 26 undefined on input line 142 9. LaTeX Warning: Reference `ss:foreignfits' on page 26 undefined on input line 14 29. LaTeX Warning: Reference `fig:overgrid' on page 26 undefined on input line 1434 . LaTeX Warning: Hyper reference `FrameSet' on page 26 undefined on input line 14 63. LaTeX Warning: Reference `ss:howtoreadwcs' on page 26 undefined on input line 1 464. [26] [27 <./sun211_figures/overgrid_bw.pdf>] [28] LaTeX Warning: Hyper reference `Plot' on page 29 undefined on input line 1558. LaTeX Warning: Reference `ss:plots' on page 29 undefined on input line 1564. LaTeX Warning: Reference `ss:classdescriptions' on page 29 undefined on input l ine 1565. LaTeX Warning: Reference `ss:howtobuild' on page 29 undefined on input line 156 8. LaTeX Warning: Hyper reference `ast_link' on page 29 undefined on input line 15 68. LaTeX Warning: Reference `ss:commanddescriptions' on page 29 undefined on input line 1569. LaTeX Warning: Hyper reference `Plot' on page 29 undefined on input line 1573. LaTeX Warning: Reference `ss:howtoplotgrid' on page 29 undefined on input line 1574. LaTeX Warning: Hyper reference `astPlot' on page 29 undefined on input line 157 6. [29] LaTeX Warning: Reference `ss:howtotestforcelestial' on page 30 undefined on inp ut line 1593. LaTeX Warning: Hyper reference `FrameSet' on page 30 undefined on input line 15 95. LaTeX Warning: Hyper reference `System' on page 30 undefined on input line 1599 . LaTeX Warning: Hyper reference `Equinox' on page 30 undefined on input line 159 9. LaTeX Warning: Hyper reference `Epoch' on page 30 undefined on input line 1599. LaTeX Warning: Reference `ss:attributedescriptions' on page 30 undefined on inp ut line 1600. LaTeX Warning: Hyper reference `Plot' on page 30 undefined on input line 1604. LaTeX Warning: Reference `ss:howtoplotgrid' on page 30 undefined on input line 1605. LaTeX Warning: Reference `ss:howtoswitchgrid' on page 30 undefined on input lin e 1606. LaTeX Warning: Hyper reference `Base' on page 30 undefined on input line 1648. LaTeX Warning: Hyper reference `Frame' on page 30 undefined on input line 1650. [30] LaTeX Warning: Reference `ss:classdescriptions' on page 31 undefined on input l ine 1679. LaTeX Warning: Reference `ss:attributedescriptions' on page 31 undefined on inp ut line 1681. [31] [32] LaTeX Warning: Hyper reference `Object' on page 33 undefined on input line 1709 . LaTeX Warning: Hyper reference `ZoomMap' on page 33 undefined on input line 171 2. LaTeX Warning: Hyper reference `Zoom' on page 33 undefined on input line 1718. LaTeX Warning: Hyper reference `Mapping' on page 33 undefined on input line 172 1. LaTeX Warning: Hyper reference `ZoomMap' on page 33 undefined on input line 172 6. LaTeX Warning: Hyper reference `astZoomMap' on page 33 undefined on input line 1742. LaTeX Warning: Hyper reference `Object' on page 33 undefined on input line 1744 . LaTeX Warning: Reference `ss:functiondescriptions' on page 33 undefined on inpu t line 1750. LaTeX Warning: Hyper reference `Zoom' on page 33 undefined on input line 1754. LaTeX Warning: Reference `ss:attributeinitialisation' on page 33 undefined on i nput line 1756. [33] LaTeX Warning: Hyper reference `ZoomMap' on page 34 undefined on input line 176 5. LaTeX Warning: Hyper reference `Object' on page 34 undefined on input line 1766 . LaTeX Warning: Hyper reference `Mapping' on page 34 undefined on input line 177 0. LaTeX Warning: Hyper reference `Plot' on page 34 undefined on input line 1814. LaTeX Warning: Reference `ss:plots' on page 34 undefined on input line 1815. LaTeX Warning: Hyper reference `FrameSet' on page 34 undefined on input line 18 16. LaTeX Warning: Hyper reference `Frame' on page 34 undefined on input line 1816. [34] LaTeX Warning: Reference `ss:classhierarchy' on page 35 undefined on input line 1834. LaTeX Warning: Hyper reference `ZoomMap' on page 35 undefined on input line 184 0. LaTeX Warning: Reference `ss:objectcreation' on page 35 undefined on input line 1841. LaTeX Warning: Hyper reference `astShow' on page 35 undefined on input line 184 2. LaTeX Warning: Reference `ss:functiondescriptions' on page 35 undefined on inpu t line 1846. LaTeX Warning: Hyper reference `Object' on page 35 undefined on input line 1847 . LaTeX Warning: Reference `ss:mappinghierarchy' on page 35 undefined on input li ne 1850. LaTeX Warning: Reference `ss:objectcreation' on page 35 undefined on input line 1876. LaTeX Warning: Hyper reference `Mapping' on page 35 undefined on input line 187 9. LaTeX Warning: Hyper reference `Nin' on page 35 undefined on input line 1880. LaTeX Warning: Hyper reference `Zoom' on page 35 undefined on input line 1882. LaTeX Warning: Reference `ss:displayingobjects' on page 35 undefined on input l ine 1887. LaTeX Warning: Hyper reference `Object' on page 35 undefined on input line 1888 . LaTeX Warning: Reference `ss:attributedescriptions' on page 35 undefined on inp ut line 1892. LaTeX Warning: Hyper reference `Nin' on page 35 undefined on input line 1896. LaTeX Warning: Hyper reference `ZoomMap' on page 35 undefined on input line 189 7. [35] LaTeX Warning: Hyper reference `Zoom' on page 36 undefined on input line 1916. LaTeX Warning: Hyper reference `Object' on page 36 undefined on input line 1944 . LaTeX Warning: Hyper reference `Nin' on page 36 undefined on input line 1944. LaTeX Warning: Hyper reference `ZoomMap' on page 36 undefined on input line 194 4. LaTeX Warning: Hyper reference `Zoom' on page 36 undefined on input line 1949. LaTeX Warning: Reference `ss:gettingattributes' on page 36 undefined on input l ine 1959. LaTeX Warning: Hyper reference `astSet' on page 36 undefined on input line 1976 . [36] LaTeX Warning: Hyper reference `Report' on page 37 undefined on input line 1988 . LaTeX Warning: Reference `ss:transforming' on page 37 undefined on input line 1 989. [37] LaTeX Warning: Reference `ss:gettingattributes' on page 38 undefined on input l ine 2080. LaTeX Warning: Hyper reference `Object' on page 38 undefined on input line 2080 . LaTeX Warning: Hyper reference `ZoomMap' on page 38 undefined on input line 209 1. LaTeX Warning: Hyper reference `astTest' on page 38 undefined on input line 210 2. LaTeX Warning: Hyper reference `astClear' on page 38 undefined on input line 21 15. LaTeX Warning: Hyper reference `Report' on page 38 undefined on input line 2124 . LaTeX Warning: Hyper reference `ZoomMap' on page 38 undefined on input line 213 1. [38] LaTeX Warning: Hyper reference `Report' on page 39 undefined on input line 2136 . LaTeX Warning: Hyper reference `Mapping' on page 39 undefined on input line 214 6. LaTeX Warning: Hyper reference `astTran2' on page 39 undefined on input line 21 66. LaTeX Warning: Reference `ss:functiondescriptions' on page 39 undefined on inpu t line 2169. LaTeX Warning: Hyper reference `Object' on page 39 undefined on input line 2170 . LaTeX Warning: Reference `ss:classhierarchy' on page 39 undefined on input line 2174. LaTeX Warning: Hyper reference `Zoom' on page 39 undefined on input line 2208. [39] LaTeX Warning: Hyper reference `Object' on page 40 undefined on input line 2248 . LaTeX Warning: Reference `ss:contexts' on page 40 undefined on input line 2251. LaTeX Warning: Hyper reference `astAnnul' on page 40 undefined on input line 22 52. LaTeX Warning: Hyper reference `RefCount' on page 40 undefined on input line 22 72. LaTeX Warning: Hyper reference `astAnnul' on page 40 undefined on input line 22 76. LaTeX Warning: Reference `ss:annullingpointers' on page 40 undefined on input l ine 2276. [40] LaTeX Warning: Hyper reference `ZoomMap' on page 41 undefined on input line 228 5. LaTeX Warning: Reference `ss:displayingobjects' on page 41 undefined on input l ine 2286. LaTeX Warning: Hyper reference `astZoomMap' on page 41 undefined on input line 2289. LaTeX Warning: Hyper reference `astBegin' on page 41 undefined on input line 22 94. LaTeX Warning: Hyper reference `astEnd' on page 41 undefined on input line 2294 . LaTeX Warning: Hyper reference `Object' on page 41 undefined on input line 2304 . LaTeX Warning: Hyper reference `astExport' on page 41 undefined on input line 2 321. LaTeX Warning: Reference `ss:contexts' on page 41 undefined on input line 2322. LaTeX Warning: Hyper reference `astEnd' on page 41 undefined on input line 2333 . LaTeX Warning: Hyper reference `astBegin' on page 41 undefined on input line 23 36. LaTeX Warning: Hyper reference `Object' on page 41 undefined on input line 2337 . LaTeX Warning: Hyper reference `astImport' on page 41 undefined on input line 2 341. LaTeX Warning: Hyper reference `astExempt' on page 41 undefined on input line 2 352. [41] LaTeX Warning: Hyper reference `astAnnul' on page 42 undefined on input line 23 62. LaTeX Warning: Hyper reference `Channel' on page 42 undefined on input line 237 9. LaTeX Warning: Hyper reference `Plot' on page 42 undefined on input line 2380. LaTeX Warning: Hyper reference `Object' on page 42 undefined on input line 2387 . LaTeX Warning: Hyper reference `Object' on page 42 undefined on input line 2396 . LaTeX Warning: Hyper reference `astAnnul' on page 42 undefined on input line 23 98. LaTeX Warning: Hyper reference `astUnlock' on page 42 undefined on input line 2 402. LaTeX Warning: Hyper reference `astLock' on page 42 undefined on input line 240 5. [42] LaTeX Warning: Hyper reference `astThread' on page 43 undefined on input line 2 421. LaTeX Warning: Hyper reference `astCopy' on page 43 undefined on input line 242 5. LaTeX Warning: Hyper reference `astEnd' on page 43 undefined on input line 2433 . LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2437 . LaTeX Warning: Hyper reference `astUnlock' on page 43 undefined on input line 2 437. LaTeX Warning: Hyper reference `astExempt' on page 43 undefined on input line 2 439. LaTeX Warning: Hyper reference `astLock' on page 43 undefined on input line 244 0. LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2449 . LaTeX Warning: Hyper reference `astCopy' on page 43 undefined on input line 246 3. LaTeX Warning: Hyper reference `Object' on page 43 undefined on input line 2486 . [43] LaTeX Warning: Reference `ss:objecthierarchy' on page 44 undefined on input lin e 2498. LaTeX Warning: Hyper reference `ZoomMap' on page 44 undefined on input line 250 9. LaTeX Warning: Hyper reference `astShow' on page 44 undefined on input line 250 9. LaTeX Warning: Reference `ss:functiondescriptions' on page 44 undefined on inpu t line 2538. LaTeX Warning: Hyper reference `astRead' on page 44 undefined on input line 254 0. [44] LaTeX Warning: Reference `ss:displayingobjects' on page 45 undefined on input l ine 2595. LaTeX Warning: Hyper reference `Object' on page 45 undefined on input line 2602 . LaTeX Warning: Hyper reference `astOK' on page 45 undefined on input line 2626. LaTeX Warning: Hyper reference `Title' on page 45 undefined on input line 2628. LaTeX Warning: Hyper reference `ZoomMap' on page 45 undefined on input line 262 8. LaTeX Warning: Hyper reference `astStatus' on page 45 undefined on input line 2 630. [45] LaTeX Warning: Hyper reference `astAnnul' on page 46 undefined on input line 26 64. LaTeX Warning: Reference `ss:functiondescriptions' on page 46 undefined on inpu t line 2686. LaTeX Warning: Hyper reference `astClearStatus' on page 46 undefined on input l ine 2691. LaTeX Warning: Reference `ss:channelsink' on page 46 undefined on input line 27 04. LaTeX Warning: Hyper reference `astSetStatus' on page 46 undefined on input lin e 2705. [46] LaTeX Warning: Hyper reference `astWatch' on page 47 undefined on input line 27 36. [47] [48] LaTeX Warning: Reference `ss:primer' on page 49 undefined on input line 2761. LaTeX Warning: Hyper reference `ZoomMap' on page 49 undefined on input line 276 1. LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 276 2. LaTeX Warning: Reference `ss:transforming' on page 49 undefined on input line 2 763. LaTeX Warning: Hyper reference `Zoom' on page 49 undefined on input line 2765. LaTeX Warning: Hyper reference `Report' on page 49 undefined on input line 2765 . LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 277 6. LaTeX Warning: Hyper reference `Frame' on page 49 undefined on input line 2802. LaTeX Warning: Reference `ss:frames' on page 49 undefined on input line 2803. LaTeX Warning: Hyper reference `Mapping' on page 49 undefined on input line 281 9. LaTeX Warning: Reference `fig:mapping' on page 49 undefined on input line 2819. LaTeX Warning: Reference `ss:transforming' on page 49 undefined on input line 2 824. [49] LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 282 8. LaTeX Warning: Hyper reference `ZoomMap' on page 50 undefined on input line 282 9. LaTeX Warning: Hyper reference `Zoom' on page 50 undefined on input line 2830. LaTeX Warning: Hyper reference `Object' on page 50 undefined on input line 2842 . LaTeX Warning: Hyper reference `Invert' on page 50 undefined on input line 2846 . LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 285 1. LaTeX Warning: Hyper reference `Nin' on page 50 undefined on input line 2858. LaTeX Warning: Hyper reference `Nout' on page 50 undefined on input line 2859. LaTeX Warning: Reference `ss:objectcreation' on page 50 undefined on input line 2863. LaTeX Warning: Hyper reference `ZoomMap' on page 50 undefined on input line 286 4. LaTeX Warning: Hyper reference `astZoomMap' on page 50 undefined on input line 2865. LaTeX Warning: Hyper reference `Mapping' on page 50 undefined on input line 288 3. [50] LaTeX Warning: Hyper reference `TranForward' on page 51 undefined on input line 2893. LaTeX Warning: Hyper reference `TranInverse' on page 51 undefined on input line 2893. LaTeX Warning: Hyper reference `LutMap' on page 51 undefined on input line 2899 . LaTeX Warning: Hyper reference `Invert' on page 51 undefined on input line 2905 . LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 290 8. LaTeX Warning: Hyper reference `Nin' on page 51 undefined on input line 2915. LaTeX Warning: Hyper reference `Nout' on page 51 undefined on input line 2915. LaTeX Warning: Hyper reference `TranForward' on page 51 undefined on input line 2916. LaTeX Warning: Hyper reference `TranInverse' on page 51 undefined on input line 2916. LaTeX Warning: Hyper reference `astInvert' on page 51 undefined on input line 2 925. LaTeX Warning: Hyper reference `astRate' on page 51 undefined on input line 294 2. LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 294 3. LaTeX Warning: Reference `ss:transforming' on page 51 undefined on input line 2 952. LaTeX Warning: Hyper reference `Report' on page 51 undefined on input line 2953 . LaTeX Warning: Hyper reference `Mapping' on page 51 undefined on input line 295 3. [51] LaTeX Warning: Hyper reference `astCopy' on page 52 undefined on input line 296 5. LaTeX Warning: Reference `ss:copyingobjects' on page 52 undefined on input line 2965. LaTeX Warning: Hyper reference `Channel' on page 52 undefined on input line 296 8. LaTeX Warning: Reference `ss:channels' on page 52 undefined on input line 2968. LaTeX Warning: Hyper reference `Mapping' on page 52 undefined on input line 297 5. LaTeX Warning: Hyper reference `ZoomMap' on page 52 undefined on input line 299 8. LaTeX Warning: Hyper reference `Zoom' on page 52 undefined on input line 2998. [52] LaTeX Warning: Hyper reference `UnitMap' on page 53 undefined on input line 302 8. LaTeX Warning: Hyper reference `Mapping' on page 53 undefined on input line 302 8. LaTeX Warning: Hyper reference `Nin' on page 53 undefined on input line 3033. LaTeX Warning: Hyper reference `Nout' on page 53 undefined on input line 3033. LaTeX Warning: Hyper reference `Invert' on page 53 undefined on input line 3048 . LaTeX Warning: Hyper reference `PermMap' on page 53 undefined on input line 305 7. LaTeX Warning: Hyper reference `Mapping' on page 53 undefined on input line 305 7. [53] [54] LaTeX Warning: Reference `ss:badcoordinates' on page 55 undefined on input line 3181. [55] [56] LaTeX Warning: Hyper reference `Mapping' on page 57 undefined on input line 319 2. LaTeX Warning: Hyper reference `CmpMap' on page 57 undefined on input line 3192 . LaTeX Warning: Hyper reference `Object' on page 57 undefined on input line 3198 . LaTeX Warning: Hyper reference `PermMap' on page 57 undefined on input line 321 0. LaTeX Warning: Reference `ss:permmapexample' on page 57 undefined on input line 3210. LaTeX Warning: Hyper reference `ZoomMap' on page 57 undefined on input line 321 3. LaTeX Warning: Reference `ss:transforming' on page 57 undefined on input line 3 213. LaTeX Warning: Reference `fig:seriescmpmap' on page 57 undefined on input line 3219. LaTeX Warning: Hyper reference `CmpMap' on page 57 undefined on input line 3219 . LaTeX Warning: Hyper reference `astCmpMap' on page 57 undefined on input line 3 248. LaTeX Warning: Hyper reference `Mapping' on page 57 undefined on input line 325 2. LaTeX Warning: Hyper reference `Nout' on page 57 undefined on input line 3258. LaTeX Warning: Hyper reference `Nin' on page 57 undefined on input line 3259. [57] LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 264. LaTeX Warning: Hyper reference `PermMap' on page 58 undefined on input line 327 3. LaTeX Warning: Hyper reference `ZoomMap' on page 58 undefined on input line 327 3. LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 274. LaTeX Warning: Reference `fig:parallelcmpmap' on page 58 undefined on input lin e 3276. LaTeX Warning: Hyper reference `CmpMap' on page 58 undefined on input line 3278 . LaTeX Warning: Hyper reference `astCmpMap' on page 58 undefined on input line 3 286. LaTeX Warning: Hyper reference `Mapping' on page 58 undefined on input line 329 2. LaTeX Warning: Hyper reference `Nin' on page 58 undefined on input line 3299. LaTeX Warning: Hyper reference `Nout' on page 58 undefined on input line 3299. LaTeX Warning: Hyper reference `CmpMap' on page 58 undefined on input line 3305 . LaTeX Warning: Reference `ss:seriescmpmap' on page 58 undefined on input line 3 307. LaTeX Warning: Hyper reference `Mapping' on page 58 undefined on input line 330 8. LaTeX Warning: Hyper reference `RefCount' on page 58 undefined on input line 33 09. LaTeX Warning: Hyper reference `astAnnul' on page 58 undefined on input line 33 11. LaTeX Warning: Reference `ss:annullingpointers' on page 58 undefined on input l ine 3313. LaTeX Warning: Reference `ss:contexts' on page 58 undefined on input line 3314. LaTeX Warning: Hyper reference `Invert' on page 58 undefined on input line 3324 . [58] LaTeX Warning: Hyper reference `CmpMap' on page 59 undefined on input line 3333 . LaTeX Warning: Hyper reference `Mapping' on page 59 undefined on input line 333 3. LaTeX Warning: Reference `ss:objecthierarchy' on page 59 undefined on input lin e 3334. LaTeX Warning: Hyper reference `astCmpMap' on page 59 undefined on input line 3 335. LaTeX Warning: Reference `fig:complexcmpmap' on page 59 undefined on input line 3355. LaTeX Warning: Hyper reference `Mapping' on page 59 undefined on input line 336 8. LaTeX Warning: Hyper reference `CmpMap' on page 59 undefined on input line 3377 . [59] LaTeX Warning: Hyper reference `astInvert' on page 60 undefined on input line 3 394. LaTeX Warning: Reference `ss:invertingmappings' on page 60 undefined on input l ine 3394. LaTeX Warning: Reference `ss:cmpmapcomponents' on page 60 undefined on input li ne 3398. LaTeX Warning: Hyper reference `CmpMap' on page 60 undefined on input line 3407 . LaTeX Warning: Reference `ss:complexcmpmap' on page 60 undefined on input line 3408. LaTeX Warning: Reference `ss:cmpmapexample' on page 60 undefined on input line 3413. LaTeX Warning: Hyper reference `Mapping' on page 60 undefined on input line 342 9. LaTeX Warning: Reference `ss:foreignfits' on page 60 undefined on input line 34 45. LaTeX Warning: Hyper reference `astSimplify' on page 60 undefined on input line 3456. LaTeX Warning: Hyper reference `CmpMap' on page 60 undefined on input line 3458 . LaTeX Warning: Reference `ss:complexcmpmap' on page 60 undefined on input line 3463. [60] LaTeX Warning: Reference `fig:simplifyexample' on page 61 undefined on input li ne 3466. LaTeX Warning: Hyper reference `UnitMap' on page 61 undefined on input line 347 2. LaTeX Warning: Hyper reference `UnitMap' on page 61 undefined on input line 347 2. LaTeX Warning: Hyper reference `Mapping' on page 61 undefined on input line 349 0. LaTeX Warning: Hyper reference `ZoomMap' on page 61 undefined on input line 349 5. LaTeX Warning: Hyper reference `Zoom' on page 61 undefined on input line 3495. LaTeX Warning: Hyper reference `PermMap' on page 61 undefined on input line 350 3. [61 <./sun211_figures/simpexamp.pdf>] [62] LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3521. LaTeX Warning: Hyper reference `Object' on page 63 undefined on input line 3521 . LaTeX Warning: Hyper reference `Mapping' on page 63 undefined on input line 352 2. LaTeX Warning: Reference `ss:mappings' on page 63 undefined on input line 3522. LaTeX Warning: Reference `ss:framesets' on page 63 undefined on input line 3525 . LaTeX Warning: Hyper reference `SkyFrame' on page 63 undefined on input line 35 29. LaTeX Warning: Hyper reference `SpecFrame' on page 63 undefined on input line 3 530. LaTeX Warning: Reference `ss:skyframes' on page 63 undefined on input line 3531 . LaTeX Warning: Reference `ss:specframes' on page 63 undefined on input line 353 1. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3537. LaTeX Warning: Hyper reference `Title' on page 63 undefined on input line 3554. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3558. LaTeX Warning: Hyper reference `astFrame' on page 63 undefined on input line 35 71. LaTeX Warning: Hyper reference `Frame' on page 63 undefined on input line 3576. LaTeX Warning: Reference `ss:creatingframes' on page 63 undefined on input line 3577. LaTeX Warning: Hyper reference `Mapping' on page 63 undefined on input line 357 7. LaTeX Warning: Reference `ss:mappingclass' on page 63 undefined on input line 3 578. LaTeX Warning: Hyper reference `Report' on page 63 undefined on input line 3581 . LaTeX Warning: Hyper reference `astTran2' on page 63 undefined on input line 35 83. [63] LaTeX Warning: Hyper reference `UnitMap' on page 64 undefined on input line 361 0. LaTeX Warning: Reference `ss:unitmapexample' on page 64 undefined on input line 3611. LaTeX Warning: Hyper reference `Nin' on page 64 undefined on input line 3612. LaTeX Warning: Hyper reference `Nout' on page 64 undefined on input line 3612. LaTeX Warning: Reference `ss:framesets' on page 64 undefined on input line 3616 . LaTeX Warning: Hyper reference `Axis' on page 64 undefined on input line 3627. LaTeX Warning: Reference `ss:gettingattributes' on page 64 undefined on input l ine 3628. LaTeX Warning: Reference `ss:settingattributes' on page 64 undefined on input l ine 3628. LaTeX Warning: Reference `ss:defaultingattributes' on page 64 undefined on inpu t line 3629. LaTeX Warning: Hyper reference `astTest' on page 64 undefined on input line 364 2. LaTeX Warning: Hyper reference `astClear' on page 64 undefined on input line 36 42. LaTeX Warning: Hyper reference `Frame' on page 64 undefined on input line 3648. [64] LaTeX Warning: Hyper reference `Naxes' on page 65 undefined on input line 3667. LaTeX Warning: Hyper reference `Frame' on page 65 undefined on input line 3698. LaTeX Warning: Hyper reference `Mapping' on page 65 undefined on input line 369 9. LaTeX Warning: Reference `ss:attributedescriptions' on page 65 undefined on inp ut line 3701. LaTeX Warning: Hyper reference `Naxes' on page 65 undefined on input line 3706. LaTeX Warning: Hyper reference `Title' on page 65 undefined on input line 3709. LaTeX Warning: Hyper reference `Label(axis)' on page 65 undefined on input line 3712. LaTeX Warning: Hyper reference `Unit(axis)' on page 65 undefined on input line 3715. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 65 undefined on input line 3718. LaTeX Warning: Reference `ss:frameunits' on page 65 undefined on input line 372 2. [65] LaTeX Warning: Hyper reference `Symbol(axis)' on page 66 undefined on input lin e 3724. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 66 undefined on in put line 3728. LaTeX Warning: Hyper reference `Format(axis)' on page 66 undefined on input lin e 3732. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 66 undefined on inpu t line 3735. LaTeX Warning: Hyper reference `Direction(axis)' on page 66 undefined on input line 3739. LaTeX Warning: Hyper reference `Domain' on page 66 undefined on input line 3748 . LaTeX Warning: Reference `ss:framedomains' on page 66 undefined on input line 3 753. LaTeX Warning: Hyper reference `System' on page 66 undefined on input line 3755 . LaTeX Warning: Hyper reference `SkyFrame' on page 66 undefined on input line 37 61. LaTeX Warning: Hyper reference `TimeFrame' on page 66 undefined on input line 3 761. LaTeX Warning: Hyper reference `SpecFrame' on page 66 undefined on input line 3 761. LaTeX Warning: Hyper reference `Epoch' on page 66 undefined on input line 3766. LaTeX Warning: Hyper reference `ObsLon' on page 66 undefined on input line 3773 . [66] LaTeX Warning: Hyper reference `ObsLat' on page 67 undefined on input line 3780 . LaTeX Warning: Hyper reference `Frame' on page 67 undefined on input line 3793. LaTeX Warning: Hyper reference `astFormat' on page 67 undefined on input line 3 795. LaTeX Warning: Hyper reference `astSet' on page 67 undefined on input line 3837 . LaTeX Warning: Hyper reference `astNorm' on page 67 undefined on input line 384 8. LaTeX Warning: Reference `ss:normalising' on page 67 undefined on input line 38 49. [67] LaTeX Warning: Hyper reference `astNorm' on page 68 undefined on input line 385 4. LaTeX Warning: Hyper reference `Frame' on page 68 undefined on input line 3859. LaTeX Warning: Reference `ss:skyframes' on page 68 undefined on input line 3861 . LaTeX Warning: Hyper reference `astFormat' on page 68 undefined on input line 3 889. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 68 undefined on inpu t line 3889. LaTeX Warning: Hyper reference `Frame' on page 68 undefined on input line 3897. LaTeX Warning: Hyper reference `astFormat' on page 68 undefined on input line 3 898. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 68 undefined on inpu t line 3899. LaTeX Warning: Hyper reference `astUnformat' on page 68 undefined on input line 3900. [68] LaTeX Warning: Hyper reference `Format(axis)' on page 69 undefined on input lin e 3992. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 69 undefined on inpu t line 3993. [69] [70] LaTeX Warning: Hyper reference `Frame' on page 71 undefined on input line 4117. [71] LaTeX Warning: Hyper reference `astPermAxes' on page 72 undefined on input line 4130. LaTeX Warning: Hyper reference `Frame' on page 72 undefined on input line 4145. LaTeX Warning: Hyper reference `astPermAxes' on page 72 undefined on input line 4147. LaTeX Warning: Reference `ss:permutingaxes' on page 72 undefined on input line 4148. LaTeX Warning: Hyper reference `astCopy' on page 72 undefined on input line 417 3. LaTeX Warning: Reference `ss:copyingobjects' on page 72 undefined on input line 4174. LaTeX Warning: Hyper reference `astPickAxes' on page 72 undefined on input line 4176. LaTeX Warning: Hyper reference `Mapping' on page 72 undefined on input line 417 7. LaTeX Warning: Hyper reference `PermMap' on page 72 undefined on input line 418 4. LaTeX Warning: Reference `ss:permmapexample' on page 72 undefined on input line 4184. [72] LaTeX Warning: Hyper reference `Frame' on page 73 undefined on input line 4224. LaTeX Warning: Hyper reference `astDistance' on page 73 undefined on input line 4232. LaTeX Warning: Hyper reference `SkyFrame' on page 73 undefined on input line 42 53. LaTeX Warning: Hyper reference `astOffset' on page 73 undefined on input line 4 256. [73] LaTeX Warning: Hyper reference `astAxDistance' on page 74 undefined on input li ne 4280. LaTeX Warning: Hyper reference `astAxOffset' on page 74 undefined on input line 4280. LaTeX Warning: Hyper reference `astOffset2' on page 74 undefined on input line 4287. LaTeX Warning: Hyper reference `astAngle' on page 74 undefined on input line 43 20. [74] LaTeX Warning: Hyper reference `astAxAngle' on page 75 undefined on input line 4328. LaTeX Warning: Hyper reference `astResolve' on page 75 undefined on input line 4332. LaTeX Warning: Hyper reference `Domain' on page 75 undefined on input line 4345 . LaTeX Warning: Hyper reference `Frame' on page 75 undefined on input line 4346. LaTeX Warning: Reference `ss:framesetconverting' on page 75 undefined on input line 4348. [75] LaTeX Warning: Reference `ss:framesets' on page 76 undefined on input line 4417 . LaTeX Warning: Reference `ss:domainconventions' on page 76 undefined on input l ine 4455. LaTeX Warning: Hyper reference `Domain' on page 76 undefined on input line 4459 . LaTeX Warning: Hyper reference `Frame' on page 76 undefined on input line 4459. [76] LaTeX Warning: Reference `ss:skyframes' on page 77 undefined on input line 4523 . LaTeX Warning: Hyper reference `SkyFrame' on page 77 undefined on input line 45 24. LaTeX Warning: Hyper reference `SpecFrame' on page 77 undefined on input line 4 529. LaTeX Warning: Reference `ss:specframes' on page 77 undefined on input line 452 9. [77] LaTeX Warning: Hyper reference `TimeFrame' on page 78 undefined on input line 4 535. LaTeX Warning: Hyper reference `Frame' on page 78 undefined on input line 4552. LaTeX Warning: Hyper reference `Plot' on page 78 undefined on input line 4561. LaTeX Warning: Hyper reference `Mapping' on page 78 undefined on input line 456 2. LaTeX Warning: Hyper reference `astConvert' on page 78 undefined on input line 4565. LaTeX Warning: Hyper reference `UnitMap' on page 78 undefined on input line 456 6. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 78 undefined on input line 4577. LaTeX Warning: Hyper reference `astGetActiveUnit' on page 78 undefined on input line 4577. LaTeX Warning: Hyper reference `SpecFrame' on page 78 undefined on input line 4 578. LaTeX Warning: Hyper reference `TimeFrame' on page 78 undefined on input line 4 578. [78] LaTeX Warning: Hyper reference `FrameSet' on page 79 undefined on input line 46 15. LaTeX Warning: Hyper reference `ZoomMap' on page 79 undefined on input line 461 7. LaTeX Warning: Hyper reference `Mapping' on page 79 undefined on input line 462 9. LaTeX Warning: Hyper reference `Full' on page 79 undefined on input line 4668. LaTeX Warning: Float too large for page by 241.1866pt on input line 4742. LaTeX Warning: Hyper reference `Axis' on page 79 undefined on input line 4792. LaTeX Warning: Hyper reference `Mapping' on page 79 undefined on input line 479 9. [79] [80] [81] [82] LaTeX Warning: Hyper reference `Frame' on page 83 undefined on input line 4806. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 08. LaTeX Warning: Reference `ss:frames' on page 83 undefined on input line 4810. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 14. LaTeX Warning: Hyper reference `Frame' on page 83 undefined on input line 4814. LaTeX Warning: Reference `ss:frames' on page 83 undefined on input line 4814. LaTeX Warning: Hyper reference `Mapping' on page 83 undefined on input line 481 5. LaTeX Warning: Reference `ss:mappings' on page 83 undefined on input line 4815. LaTeX Warning: Reference `ss:frameasmapping' on page 83 undefined on input line 4818. LaTeX Warning: Hyper reference `UnitMap' on page 83 undefined on input line 481 8. LaTeX Warning: Hyper reference `astPermAxes' on page 83 undefined on input line 4836. LaTeX Warning: Reference `ss:permutingaxes' on page 83 undefined on input line 4836. LaTeX Warning: Hyper reference `LatAxis' on page 83 undefined on input line 483 7. LaTeX Warning: Hyper reference `LonAxis' on page 83 undefined on input line 483 7. LaTeX Warning: Hyper reference `SkyFrame' on page 83 undefined on input line 48 47. [83] LaTeX Warning: Hyper reference `SkyFrame' on page 84 undefined on input line 48 73. LaTeX Warning: Hyper reference `System' on page 84 undefined on input line 4873 . LaTeX Warning: Hyper reference `Equinox' on page 84 undefined on input line 488 6. LaTeX Warning: Reference `ss:equinoxitem' on page 84 undefined on input line 48 86. LaTeX Warning: Reference `ss:attributedescriptions' on page 84 undefined on inp ut line 4891. LaTeX Warning: Hyper reference `Mapping' on page 84 undefined on input line 489 6. LaTeX Warning: Reference `ss:introducingconversion' on page 84 undefined on inp ut line 4898. LaTeX Warning: Hyper reference `SkyFrame' on page 84 undefined on input line 49 10. LaTeX Warning: Hyper reference `System' on page 84 undefined on input line 4912 . LaTeX Warning: Hyper reference `Frame' on page 84 undefined on input line 4920. LaTeX Warning: Hyper reference `Epoch' on page 84 undefined on input line 4930. LaTeX Warning: Hyper reference `Equinox' on page 84 undefined on input line 493 5. [84] LaTeX Warning: Reference `ss:attributedescriptions' on page 85 undefined on inp ut line 4962. LaTeX Warning: Reference `ss:attributedescriptions' on page 85 undefined on inp ut line 4964. LaTeX Warning: Hyper reference `SkyFrame' on page 85 undefined on input line 49 89. LaTeX Warning: Hyper reference `System' on page 85 undefined on input line 4990 . LaTeX Warning: Hyper reference `astShow' on page 85 undefined on input line 499 3. [85] LaTeX Warning: Hyper reference `Title' on page 86 undefined on input line 5030. LaTeX Warning: Hyper reference `astFormat' on page 86 undefined on input line 5 036. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 86 undefined on inpu t line 5037. LaTeX Warning: Hyper reference `Frame' on page 86 undefined on input line 5040. LaTeX Warning: Hyper reference `astFormat' on page 86 undefined on input line 5 055. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 86 undefined on inpu t line 5056. LaTeX Warning: Hyper reference `SkyFrame' on page 86 undefined on input line 50 60. LaTeX Warning: Hyper reference `Frame' on page 86 undefined on input line 5061. LaTeX Warning: Reference `ss:formattingwithdigits' on page 86 undefined on inpu t line 5061. LaTeX Warning: Hyper reference `Format(axis)' on page 86 undefined on input lin e 5064. LaTeX Warning: Reference `ss:attributedescriptions' on page 86 undefined on inp ut line 5069. [86] [87] LaTeX Warning: Hyper reference `AsTime(axis)' on page 88 undefined on input lin e 5134. LaTeX Warning: Hyper reference `System' on page 88 undefined on input line 5140 . LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 88 undefined on in put line 5148. LaTeX Warning: Hyper reference `astFormat' on page 88 undefined on input line 5 159. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 88 undefined on i nput line 5160. LaTeX Warning: Hyper reference `astUnformat' on page 88 undefined on input line 5161. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 88 undefined on in put line 5162. LaTeX Warning: Hyper reference `SkyFrame' on page 88 undefined on input line 51 63. [88] LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 89 undefined on i nput line 5232. [89] LaTeX Warning: Hyper reference `Format(axis)' on page 90 undefined on input lin e 5278. [90] LaTeX Warning: Hyper reference `SkyFrame' on page 91 undefined on input line 53 33. LaTeX Warning: Hyper reference `System' on page 91 undefined on input line 5335 . [91] LaTeX Warning: Hyper reference `SkyRefIs' on page 92 undefined on input line 53 51. [92] LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 362. LaTeX Warning: Hyper reference `Frame' on page 93 undefined on input line 5362. LaTeX Warning: Reference `ss:frames' on page 93 undefined on input line 5365. LaTeX Warning: Hyper reference `SkyFrame' on page 93 undefined on input line 53 69. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 369. LaTeX Warning: Hyper reference `Frame' on page 93 undefined on input line 5369. LaTeX Warning: Reference `ss:frames' on page 93 undefined on input line 5369. LaTeX Warning: Hyper reference `Mapping' on page 93 undefined on input line 537 0. LaTeX Warning: Reference `ss:mappings' on page 93 undefined on input line 5370. LaTeX Warning: Reference `ss:frameasmapping' on page 93 undefined on input line 5373. LaTeX Warning: Hyper reference `UnitMap' on page 93 undefined on input line 537 3. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 384. LaTeX Warning: Hyper reference `SpecFrame' on page 93 undefined on input line 5 406. LaTeX Warning: Hyper reference `System' on page 93 undefined on input line 5406 . LaTeX Warning: Reference `ss:attributedescriptions' on page 93 undefined on inp ut line 5422. [93] LaTeX Warning: Hyper reference `SpecFrame' on page 94 undefined on input line 5 436. LaTeX Warning: Hyper reference `System' on page 94 undefined on input line 5438 . LaTeX Warning: Hyper reference `Frame' on page 94 undefined on input line 5446. LaTeX Warning: Hyper reference `Epoch' on page 94 undefined on input line 5456. LaTeX Warning: Hyper reference `StdOfRest' on page 94 undefined on input line 5 463. LaTeX Warning: Hyper reference `RestFreq' on page 94 undefined on input line 54 69. LaTeX Warning: Hyper reference `RefRA' on page 94 undefined on input line 5475. LaTeX Warning: Hyper reference `RefDec' on page 94 undefined on input line 5480 . LaTeX Warning: Hyper reference `SourceVel' on page 94 undefined on input line 5 484. LaTeX Warning: Reference `ss:attributedescriptions' on page 94 undefined on inp ut line 5494. LaTeX Warning: Reference `ss:attributedescriptions' on page 94 undefined on inp ut line 5496. [94] LaTeX Warning: Hyper reference `SpecFrame' on page 95 undefined on input line 5 505. LaTeX Warning: Hyper reference `System' on page 95 undefined on input line 5506 . LaTeX Warning: Hyper reference `astShow' on page 95 undefined on input line 550 9. LaTeX Warning: Hyper reference `Title' on page 95 undefined on input line 5539. [95] LaTeX Warning: Hyper reference `astConvert' on page 96 undefined on input line 5575. LaTeX Warning: Hyper reference `RefRA' on page 96 undefined on input line 5582. LaTeX Warning: Hyper reference `RefDec' on page 96 undefined on input line 5582 . LaTeX Warning: Hyper reference `RestFreq' on page 96 undefined on input line 55 85. LaTeX Warning: Hyper reference `SpecFrame' on page 96 undefined on input line 5 595. LaTeX Warning: Hyper reference `Frame' on page 96 undefined on input line 5597. LaTeX Warning: Hyper reference `SkyFrame' on page 96 undefined on input line 55 98. LaTeX Warning: Hyper reference `CmpFrame' on page 96 undefined on input line 55 99. LaTeX Warning: Hyper reference `astPermAxes' on page 96 undefined on input line 5616. LaTeX Warning: Hyper reference `RefRA' on page 96 undefined on input line 5623. LaTeX Warning: Hyper reference `RefDec' on page 96 undefined on input line 5623 . [96] LaTeX Warning: Reference `fig:dsbspec1' on page 97 undefined on input line 5669 . LaTeX Warning: Hyper reference `SpecFrame' on page 97 undefined on input line 5 689. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 97 undefined on input lin e 5693. LaTeX Warning: Hyper reference `SideBand' on page 97 undefined on input line 56 95. LaTeX Warning: Hyper reference `astConvert' on page 97 undefined on input line 5702. LaTeX Warning: Hyper reference `Mapping' on page 97 undefined on input line 570 3. LaTeX Warning: Reference `eqn:dsb' on page 97 undefined on input line 5704. [97] LaTeX Warning: Hyper reference `DSBCentre' on page 98 undefined on input line 5 729. LaTeX Warning: Hyper reference `IF' on page 98 undefined on input line 5730. LaTeX Warning: Reference `fig:dsbspec1' on page 98 undefined on input line 5732 . [98 <./sun211_figures/dsbspec1.pdf>] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 99 undefined on input lin e 5755. LaTeX Warning: Hyper reference `FrameSet' on page 99 undefined on input line 57 57. LaTeX Warning: Hyper reference `Frame' on page 99 undefined on input line 5758. LaTeX Warning: Hyper reference `DSBCentre' on page 99 undefined on input line 5 761. LaTeX Warning: Hyper reference `IF' on page 99 undefined on input line 5761. LaTeX Warning: Hyper reference `Mapping' on page 99 undefined on input line 576 2. LaTeX Warning: Hyper reference `SpecFrame' on page 99 undefined on input line 5 767. LaTeX Warning: Hyper reference `System' on page 99 undefined on input line 5767 . LaTeX Warning: Hyper reference `StdOfRest' on page 99 undefined on input line 5 767. LaTeX Warning: Hyper reference `Epoch' on page 99 undefined on input line 5767. LaTeX Warning: Hyper reference `SideBand' on page 99 undefined on input line 57 67. LaTeX Warning: Reference `fig:dsbspec1' on page 99 undefined on input line 5776 . [99] LaTeX Warning: Reference `ss:framesetintegrity' on page 100 undefined on input line 5867. LaTeX Warning: Reference `fig:dsbspec2' on page 100 undefined on input line 586 8. LaTeX Warning: Hyper reference `astConvert' on page 100 undefined on input line 5869. [100] LaTeX Warning: Reference `eqn:dsb' on page 101 undefined on input line 5899. LaTeX Warning: Reference `fig:dsbspec3' on page 101 undefined on input line 590 6. LaTeX Warning: Reference `ss:alignmentsystem' on page 101 undefined on input li ne 5941. [101 <./sun211_figures/dsbspec2.pdf>] LaTeX Warning: Hyper reference `UnitMap' on page 102 undefined on input line 59 50. [102 <./sun211_figures/dsbspec3.pdf>] LaTeX Warning: Hyper reference `TimeFrame' on page 103 undefined on input line 5966. LaTeX Warning: Hyper reference `Frame' on page 103 undefined on input line 5966 . LaTeX Warning: Reference `ss:frames' on page 103 undefined on input line 5968. LaTeX Warning: Hyper reference `SkyFrame' on page 103 undefined on input line 5 972. LaTeX Warning: Hyper reference `TimeFrame' on page 103 undefined on input line 5972. LaTeX Warning: Hyper reference `Frame' on page 103 undefined on input line 5972 . LaTeX Warning: Reference `ss:frames' on page 103 undefined on input line 5972. LaTeX Warning: Hyper reference `Mapping' on page 103 undefined on input line 59 73. LaTeX Warning: Reference `ss:mappings' on page 103 undefined on input line 5973 . LaTeX Warning: Reference `ss:frameasmapping' on page 103 undefined on input lin e 5976. LaTeX Warning: Hyper reference `UnitMap' on page 103 undefined on input line 59 76. LaTeX Warning: Hyper reference `TimeOrigin' on page 103 undefined on input line 5982. LaTeX Warning: Hyper reference `TimeScale' on page 103 undefined on input line 5983. LaTeX Warning: Hyper reference `Epoch' on page 103 undefined on input line 5984 . LaTeX Warning: Hyper reference `System' on page 103 undefined on input line 598 5. LaTeX Warning: Hyper reference `TimeFrame' on page 103 undefined on input line 5992. LaTeX Warning: Hyper reference `System' on page 103 undefined on input line 601 1. LaTeX Warning: Hyper reference `TimeFrame' on page 103 undefined on input line 6011. LaTeX Warning: Hyper reference `Epoch' on page 103 undefined on input line 6012 . LaTeX Warning: Hyper reference `TimeScale' on page 103 undefined on input line 6013. [103] LaTeX Warning: Reference `ss:attributedescriptions' on page 104 undefined on in put line 6033. LaTeX Warning: Hyper reference `TimeFrame' on page 104 undefined on input line 6043. LaTeX Warning: Hyper reference `System' on page 104 undefined on input line 604 5. LaTeX Warning: Hyper reference `Frame' on page 104 undefined on input line 6052 . LaTeX Warning: Hyper reference `TimeScale' on page 104 undefined on input line 6061. LaTeX Warning: Hyper reference `LTOffset' on page 104 undefined on input line 6 064. LaTeX Warning: Hyper reference `TimeOrigin' on page 104 undefined on input line 6069. LaTeX Warning: Reference `ss:attributedescriptions' on page 104 undefined on in put line 6080. LaTeX Warning: Reference `ss:attributedescriptions' on page 104 undefined on in put line 6082. [104] LaTeX Warning: Hyper reference `Mapping' on page 105 undefined on input line 60 92. LaTeX Warning: Hyper reference `CmpFrame' on page 105 undefined on input line 6 092. LaTeX Warning: Hyper reference `Frame' on page 105 undefined on input line 6095 . LaTeX Warning: Hyper reference `Object' on page 105 undefined on input line 609 8. LaTeX Warning: Hyper reference `CmpFrame' on page 105 undefined on input line 6 105. LaTeX Warning: Hyper reference `Frame' on page 105 undefined on input line 6106 . LaTeX Warning: Hyper reference `SkyFrame' on page 105 undefined on input line 6 112. LaTeX Warning: Hyper reference `SpecFrame' on page 105 undefined on input line 6112. LaTeX Warning: Hyper reference `CmpFrame' on page 105 undefined on input line 6 144. LaTeX Warning: Hyper reference `Frame' on page 105 undefined on input line 6144 . LaTeX Warning: Hyper reference `Domain' on page 105 undefined on input line 614 5. LaTeX Warning: Hyper reference `System' on page 105 undefined on input line 614 9. [105] LaTeX Warning: Hyper reference `Epoch' on page 106 undefined on input line 6163 . LaTeX Warning: Hyper reference `Title' on page 106 undefined on input line 6163 . LaTeX Warning: Hyper reference `SpecFrame' on page 106 undefined on input line 6166. LaTeX Warning: Hyper reference `SkyFrame' on page 106 undefined on input line 6 166. LaTeX Warning: Hyper reference `Equinox' on page 106 undefined on input line 61 74. [106] LaTeX Warning: Reference `ss:frames' on page 107 undefined on input line 6203. LaTeX Warning: Reference `ss:skyframes' on page 107 undefined on input line 620 3. LaTeX Warning: Reference `ss:specframes' on page 107 undefined on input line 62 04. LaTeX Warning: Reference `ss:timeframes' on page 107 undefined on input line 62 04. LaTeX Warning: Reference `ss:mappings' on page 107 undefined on input line 6205 . LaTeX Warning: Reference `ss:framesetconverting' on page 107 undefined on input line 6207. LaTeX Warning: Hyper reference `SkyFrame' on page 107 undefined on input line 6 244. LaTeX Warning: Hyper reference `astConvert' on page 107 undefined on input line 6246. LaTeX Warning: Hyper reference `Object' on page 107 undefined on input line 626 9. [107] LaTeX Warning: Hyper reference `FrameSet' on page 108 undefined on input line 6 271. LaTeX Warning: Reference `ss:framesets' on page 108 undefined on input line 627 2. LaTeX Warning: Hyper reference `Mapping' on page 108 undefined on input line 62 74. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 108 undefined on inp ut line 6277. LaTeX Warning: Hyper reference `astTran2' on page 108 undefined on input line 6 300. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 108 undefined on inp ut line 6310. LaTeX Warning: Hyper reference `Frame' on page 108 undefined on input line 6311 . LaTeX Warning: Hyper reference `astDistance' on page 108 undefined on input lin e 6315. LaTeX Warning: Hyper reference `Report' on page 108 undefined on input line 633 1. LaTeX Warning: Reference `ss:transforming' on page 108 undefined on input line 6333. [108] LaTeX Warning: Hyper reference `SpecFrame' on page 109 undefined on input line 6381. [109] LaTeX Warning: Hyper reference `Epoch' on page 110 undefined on input line 6419 . LaTeX Warning: Hyper reference `ObsLat' on page 110 undefined on input line 642 0. LaTeX Warning: Hyper reference `ObsLon' on page 110 undefined on input line 642 0. LaTeX Warning: Hyper reference `RefRA' on page 110 undefined on input line 6421 . LaTeX Warning: Hyper reference `RefDec' on page 110 undefined on input line 642 1. LaTeX Warning: Hyper reference `RestFreq' on page 110 undefined on input line 6 421. LaTeX Warning: Hyper reference `StdOfRest' on page 110 undefined on input line 6422. LaTeX Warning: Hyper reference `FrameSet' on page 110 undefined on input line 6 443. LaTeX Warning: Hyper reference `astTran1' on page 110 undefined on input line 6 446. LaTeX Warning: Hyper reference `astTran2' on page 110 undefined on input line 6 446. LaTeX Warning: Hyper reference `SkyFrame' on page 110 undefined on input line 6 447. LaTeX Warning: Hyper reference `SkyFrame' on page 110 undefined on input line 6 477. LaTeX Warning: Reference `ss:convertingskyframes' on page 110 undefined on inpu t line 6477. LaTeX Warning: Hyper reference `astPermAxes' on page 110 undefined on input lin e 6478. LaTeX Warning: Reference `ss:permutingaxes' on page 110 undefined on input line 6479. LaTeX Warning: Hyper reference `astConvert' on page 110 undefined on input line 6480. [110] LaTeX Warning: Hyper reference `FrameSet' on page 111 undefined on input line 6 506. LaTeX Warning: Reference `ss:convertingskyframes' on page 111 undefined on inpu t line 6523. LaTeX Warning: Hyper reference `LatAxis' on page 111 undefined on input line 65 36. LaTeX Warning: Hyper reference `LonAxis' on page 111 undefined on input line 65 36. LaTeX Warning: Reference `ss:convertingskyframes' on page 111 undefined on inpu t line 6542. LaTeX Warning: Reference `ss:convertingpermutedaxes' on page 111 undefined on i nput line 6543. LaTeX Warning: Hyper reference `Frame' on page 111 undefined on input line 6544 . LaTeX Warning: Hyper reference `astConvert' on page 111 undefined on input line 6545. [111] LaTeX Warning: Hyper reference `FrameSet' on page 112 undefined on input line 6 560. LaTeX Warning: Hyper reference `UnitMap' on page 112 undefined on input line 65 71. LaTeX Warning: Reference `ss:unitmapexample' on page 112 undefined on input lin e 6572. LaTeX Warning: Reference `ss:convertingpermutedaxes' on page 112 undefined on i nput line 6573. LaTeX Warning: Hyper reference `SkyFrame' on page 112 undefined on input line 6 577. LaTeX Warning: Hyper reference `Mapping' on page 112 undefined on input line 66 49. LaTeX Warning: Hyper reference `Domain' on page 112 undefined on input line 665 6. LaTeX Warning: Hyper reference `Frame' on page 112 undefined on input line 6668 . LaTeX Warning: Hyper reference `AlignSystem' on page 112 undefined on input lin e 6668. LaTeX Warning: Hyper reference `SpecFrame' on page 112 undefined on input line 6673. [112] LaTeX Warning: Hyper reference `AlignStdOfRest' on page 113 undefined on input line 6693. LaTeX Warning: Hyper reference `TimeFrame' on page 113 undefined on input line 6695. LaTeX Warning: Hyper reference `AlignTimeScale' on page 113 undefined on input line 6695. LaTeX Warning: Hyper reference `SkyFrame' on page 113 undefined on input line 6 697. [113] [114] LaTeX Warning: Reference `ss:introducingconversion' on page 115 undefined on in put line 6703. LaTeX Warning: Hyper reference `astConvert' on page 115 undefined on input line 6703. LaTeX Warning: Hyper reference `Mapping' on page 115 undefined on input line 67 04. LaTeX Warning: Reference `ss:framedomains' on page 115 undefined on input line 6728. LaTeX Warning: Hyper reference `Domain' on page 115 undefined on input line 672 9. LaTeX Warning: Hyper reference `FrameSet' on page 115 undefined on input line 6 737. LaTeX Warning: Hyper reference `Frame' on page 115 undefined on input line 6742 . LaTeX Warning: Hyper reference `Mapping' on page 115 undefined on input line 67 42. LaTeX Warning: Hyper reference `FrameSet' on page 115 undefined on input line 6 767. LaTeX Warning: Reference `fig:frameset' on page 115 undefined on input line 676 7. [115] LaTeX Warning: Hyper reference `FrameSet' on page 116 undefined on input line 6 776. LaTeX Warning: Hyper reference `Frame' on page 116 undefined on input line 6776 . LaTeX Warning: Hyper reference `Domain' on page 116 undefined on input line 679 0. LaTeX Warning: Reference `ss:framedomains' on page 116 undefined on input line 6790. LaTeX Warning: Hyper reference `FrameSet' on page 116 undefined on input line 6 808. LaTeX Warning: Reference `ss:creatingaframeset' on page 116 undefined on input line 6809. LaTeX Warning: Hyper reference `Frame' on page 116 undefined on input line 6809 . LaTeX Warning: Hyper reference `Mapping' on page 116 undefined on input line 68 10. LaTeX Warning: Hyper reference `ZoomMap' on page 116 undefined on input line 68 12. LaTeX Warning: Hyper reference `astAddFrame' on page 116 undefined on input lin e 6827. LaTeX Warning: Reference `ss:creatingaframeset' on page 116 undefined on input line 6838. LaTeX Warning: Hyper reference `astCopy' on page 116 undefined on input line 68 50. LaTeX Warning: Reference `ss:copyingobjects' on page 116 undefined on input lin e 6851. LaTeX Warning: Hyper reference `Object' on page 116 undefined on input line 685 1. [116] LaTeX Warning: Hyper reference `astBegin' on page 117 undefined on input line 6 866. LaTeX Warning: Hyper reference `astEnd' on page 117 undefined on input line 686 6. LaTeX Warning: Reference `ss:contexts' on page 117 undefined on input line 6866 . LaTeX Warning: Reference `fig:fsexample' on page 117 undefined on input line 68 70. LaTeX Warning: Hyper reference `Base' on page 117 undefined on input line 6879. LaTeX Warning: Hyper reference `Current' on page 117 undefined on input line 68 79. LaTeX Warning: Hyper reference `Base' on page 117 undefined on input line 6879. LaTeX Warning: Hyper reference `Current' on page 117 undefined on input line 68 79. LaTeX Warning: Hyper reference `Nframe' on page 117 undefined on input line 688 3. LaTeX Warning: Hyper reference `FrameSet' on page 117 undefined on input line 6 887. LaTeX Warning: Hyper reference `Frame' on page 117 undefined on input line 6888 . LaTeX Warning: Reference `fig:fsexample' on page 117 undefined on input line 68 89. LaTeX Warning: Hyper reference `Base' on page 117 undefined on input line 6890. LaTeX Warning: Hyper reference `Current' on page 117 undefined on input line 68 90. [117 <./sun211_figures/fsexample.pdf>] LaTeX Warning: Hyper reference `Invert' on page 118 undefined on input line 692 6. LaTeX Warning: Reference `fig:fsexample' on page 118 undefined on input line 69 30. LaTeX Warning: Reference `ss:baseandcurrent' on page 118 undefined on input lin e 6935. LaTeX Warning: Hyper reference `FrameSet' on page 118 undefined on input line 6 935. LaTeX Warning: Hyper reference `Base' on page 118 undefined on input line 6936. LaTeX Warning: Hyper reference `Current' on page 118 undefined on input line 69 36. LaTeX Warning: Hyper reference `Frame' on page 118 undefined on input line 6940 . LaTeX Warning: Reference `ss:addingframes' on page 118 undefined on input line 6944. LaTeX Warning: Hyper reference `FrameSet' on page 118 undefined on input line 6 964. LaTeX Warning: Hyper reference `Frame' on page 118 undefined on input line 6964 . LaTeX Warning: Reference `ss:frames' on page 118 undefined on input line 6965. LaTeX Warning: Hyper reference `Mapping' on page 118 undefined on input line 69 65. LaTeX Warning: Reference `ss:mappings' on page 118 undefined on input line 6966 . [118] LaTeX Warning: Hyper reference `astTran2' on page 119 undefined on input line 6 970. LaTeX Warning: Reference `fig:fsexample' on page 119 undefined on input line 69 85. LaTeX Warning: Hyper reference `Nin' on page 119 undefined on input line 6993. LaTeX Warning: Hyper reference `Nout' on page 119 undefined on input line 6993. LaTeX Warning: Hyper reference `Invert' on page 119 undefined on input line 699 9. LaTeX Warning: Hyper reference `astInvert' on page 119 undefined on input line 6999. LaTeX Warning: Reference `ss:invertingmappings' on page 119 undefined on input line 7000. LaTeX Warning: Hyper reference `Base' on page 119 undefined on input line 7001. LaTeX Warning: Hyper reference `Current' on page 119 undefined on input line 70 01. LaTeX Warning: Hyper reference `FrameSet' on page 119 undefined on input line 7 012. LaTeX Warning: Hyper reference `Mapping' on page 119 undefined on input line 70 12. LaTeX Warning: Reference `ss:framesetasmapping' on page 119 undefined on input line 7013. LaTeX Warning: Hyper reference `astGetMapping' on page 119 undefined on input l ine 7020. LaTeX Warning: Hyper reference `astCopy' on page 119 undefined on input line 70 36. LaTeX Warning: Reference `ss:copyingobjects' on page 119 undefined on input lin e 7037. [119] LaTeX Warning: Hyper reference `CmpMap' on page 120 undefined on input line 704 0. LaTeX Warning: Reference `ss:cmpmaps' on page 120 undefined on input line 7040. LaTeX Warning: Hyper reference `astSimplify' on page 120 undefined on input lin e 7044. LaTeX Warning: Reference `ss:simplifyingcmpmaps' on page 120 undefined on input line 7044. LaTeX Warning: Hyper reference `FrameSet' on page 120 undefined on input line 7 050. LaTeX Warning: Hyper reference `Frame' on page 120 undefined on input line 7050 . LaTeX Warning: Hyper reference `Title' on page 120 undefined on input line 7052 . LaTeX Warning: Hyper reference `Naxes' on page 120 undefined on input line 7068 . LaTeX Warning: Hyper reference `Label(axis)' on page 120 undefined on input lin e 7068. LaTeX Warning: Hyper reference `Format(axis)' on page 120 undefined on input li ne 7069. LaTeX Warning: Hyper reference `Class' on page 120 undefined on input line 7073 . LaTeX Warning: Hyper reference `ID' on page 120 undefined on input line 7076. LaTeX Warning: Hyper reference `Nin' on page 120 undefined on input line 7079. LaTeX Warning: Hyper reference `Invert' on page 120 undefined on input line 708 2. LaTeX Warning: Hyper reference `Nobject' on page 120 undefined on input line 70 85. LaTeX Warning: Hyper reference `RefCount' on page 120 undefined on input line 7 088. LaTeX Warning: Hyper reference `SkyFrame' on page 120 undefined on input line 7 096. LaTeX Warning: Reference `ss:skyframes' on page 120 undefined on input line 709 6. LaTeX Warning: Hyper reference `Equinox' on page 120 undefined on input line 70 97. LaTeX Warning: Hyper reference `FrameSet' on page 120 undefined on input line 7 105. LaTeX Warning: Hyper reference `Frame' on page 120 undefined on input line 7105 . LaTeX Warning: Hyper reference `astGetFrame' on page 120 undefined on input lin e 7107. [120] LaTeX Warning: Reference `ss:astbaseandastcurrent' on page 121 undefined on inp ut line 7118. LaTeX Warning: Hyper reference `Base' on page 121 undefined on input line 7119. LaTeX Warning: Hyper reference `Frame' on page 121 undefined on input line 7123 . LaTeX Warning: Hyper reference `FrameSet' on page 121 undefined on input line 7 123. LaTeX Warning: Hyper reference `astRemoveFrame' on page 121 undefined on input line 7124. LaTeX Warning: Hyper reference `Nframe' on page 121 undefined on input line 713 8. LaTeX Warning: Hyper reference `Base' on page 121 undefined on input line 7141. LaTeX Warning: Hyper reference `Current' on page 121 undefined on input line 71 42. LaTeX Warning: Reference `ss:baseandcurrentdefault' on page 121 undefined on in put line 7145. LaTeX Warning: Reference `fig:fsexample' on page 121 undefined on input line 71 50. [121] [122] LaTeX Warning: Reference `ss:framesetconverting' on page 123 undefined on input line 7160. LaTeX Warning: Hyper reference `astConvert' on page 123 undefined on input line 7161. LaTeX Warning: Reference `ss:introducingconversion' on page 123 undefined on in put line 7162. LaTeX Warning: Hyper reference `Frame' on page 123 undefined on input line 7164 . LaTeX Warning: Hyper reference `FrameSet' on page 123 undefined on input line 7 164. LaTeX Warning: Reference `ss:convertingskyframes' on page 123 undefined on inpu t line 7168. LaTeX Warning: Reference `fig:fsconvert' on page 123 undefined on input line 71 88. LaTeX Warning: Hyper reference `SkyFrame' on page 123 undefined on input line 7 196. LaTeX Warning: Hyper reference `Mapping' on page 123 undefined on input line 71 96. LaTeX Warning: Hyper reference `SkyFrame' on page 123 undefined on input line 7 196. LaTeX Warning: Hyper reference `Mapping' on page 123 undefined on input line 71 96. LaTeX Warning: Reference `ss:convertingskyframes' on page 123 undefined on inpu t line 7208. LaTeX Warning: Hyper reference `astGetMapping' on page 123 undefined on input l ine 7212. LaTeX Warning: Reference `ss:extractingamapping' on page 123 undefined on input line 7212. [123 <./sun211_figures/fsconvert.pdf>] LaTeX Warning: Reference `ss:registeringimages' on page 124 undefined on input line 7228. LaTeX Warning: Reference `fig:fsalign' on page 124 undefined on input line 7229 . LaTeX Warning: Hyper reference `FrameSet' on page 124 undefined on input line 7 240. LaTeX Warning: Hyper reference `Domain' on page 124 undefined on input line 724 0. LaTeX Warning: Hyper reference `FrameSet' on page 124 undefined on input line 7 240. LaTeX Warning: Hyper reference `Domain' on page 124 undefined on input line 724 0. LaTeX Warning: Reference `ss:framesetasframe' on page 124 undefined on input li ne 7245. LaTeX Warning: Hyper reference `Frame' on page 124 undefined on input line 7246 . LaTeX Warning: Hyper reference `astConvert' on page 124 undefined on input line 7247. LaTeX Warning: Reference `ss:convertingskyframes' on page 124 undefined on inpu t line 7248. LaTeX Warning: Reference `fig:fsalign' on page 124 undefined on input line 7267 . LaTeX Warning: Reference `ss:framedomains' on page 124 undefined on input line 7273. LaTeX Warning: Hyper reference `SkyFrame' on page 124 undefined on input line 7 292. LaTeX Warning: Reference `ss:framedomains' on page 124 undefined on input line 7296. [124] [125 <./sun211_figures/fsalign.pdf>] LaTeX Warning: Reference `ss:functiondescriptions' on page 126 undefined on inp ut line 7309. LaTeX Warning: Hyper reference `Mapping' on page 126 undefined on input line 73 15. LaTeX Warning: Reference `ss:framesetsfromconvert' on page 126 undefined on inp ut line 7348. LaTeX Warning: Hyper reference `Base' on page 126 undefined on input line 7356. LaTeX Warning: Reference `ss:baseandcurrent' on page 126 undefined on input lin e 7358. LaTeX Warning: Hyper reference `Frame' on page 126 undefined on input line 7368 . LaTeX Warning: Hyper reference `FrameSet' on page 126 undefined on input line 7 368. LaTeX Warning: Reference `ss:domainconventions' on page 126 undefined on input line 7370. [126] LaTeX Warning: Hyper reference `astCopy' on page 127 undefined on input line 73 79. LaTeX Warning: Reference `ss:copyingobjects' on page 127 undefined on input lin e 7379. LaTeX Warning: Hyper reference `astInvert' on page 127 undefined on input line 7385. LaTeX Warning: Hyper reference `astConvert' on page 127 undefined on input line 7394. LaTeX Warning: Reference `ss:framedomains' on page 127 undefined on input line 7420. LaTeX Warning: Reference `ss:convertingskyframes' on page 127 undefined on inpu t line 7436. LaTeX Warning: Hyper reference `Base' on page 127 undefined on input line 7441. LaTeX Warning: Hyper reference `Domain' on page 127 undefined on input line 744 4. [127] LaTeX Warning: Reference `ss:baseandcurrent' on page 128 undefined on input lin e 7462. LaTeX Warning: Hyper reference `FrameSet' on page 128 undefined on input line 7 463. LaTeX Warning: Hyper reference `Frame' on page 128 undefined on input line 7470 . LaTeX Warning: Hyper reference `Mapping' on page 128 undefined on input line 74 93. LaTeX Warning: Hyper reference `astGetFrame' on page 128 undefined on input lin e 7497. [128] LaTeX Warning: Reference `fig:fsremap' on page 129 undefined on input line 7518 . LaTeX Warning: Hyper reference `astRemapFrame' on page 129 undefined on input l ine 7529. LaTeX Warning: Hyper reference `astRemapFrame' on page 129 undefined on input l ine 7529. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 129 undefined on inp ut line 7537. LaTeX Warning: Hyper reference `astRemapFrame' on page 129 undefined on input l ine 7541. LaTeX Warning: Hyper reference `FrameSet' on page 129 undefined on input line 7 544. LaTeX Warning: Hyper reference `Mapping' on page 129 undefined on input line 75 48. LaTeX Warning: Hyper reference `WinMap' on page 129 undefined on input line 754 8. [129 <./sun211_figures/fsremap.pdf>] LaTeX Warning: Hyper reference `astWinMap' on page 130 undefined on input line 7569. LaTeX Warning: Hyper reference `Frame' on page 130 undefined on input line 7573 . LaTeX Warning: Hyper reference `FrameSet' on page 130 undefined on input line 7 593. LaTeX Warning: Hyper reference `Mapping' on page 130 undefined on input line 75 99. LaTeX Warning: Hyper reference `Frame' on page 130 undefined on input line 7615 . LaTeX Warning: Hyper reference `SkyFrame' on page 130 undefined on input line 7 616. LaTeX Warning: Hyper reference `Equinox' on page 130 undefined on input line 76 16. LaTeX Warning: Hyper reference `astSet' on page 130 undefined on input line 761 7. [130] LaTeX Warning: Hyper reference `astRemapFrame' on page 131 undefined on input l ine 7638. LaTeX Warning: Reference `ss:remapframe' on page 131 undefined on input line 76 38. LaTeX Warning: Hyper reference `UnitMap' on page 131 undefined on input line 76 54. LaTeX Warning: Hyper reference `astClear' on page 131 undefined on input line 7 682. LaTeX Warning: Hyper reference `astPermAxes' on page 131 undefined on input lin e 7682. LaTeX Warning: Reference `ss:permutingaxes' on page 131 undefined on input line 7683. LaTeX Warning: Hyper reference `FrameSet' on page 131 undefined on input line 7 706. LaTeX Warning: Reference `ss:addingframes' on page 131 undefined on input line 7707. LaTeX Warning: Reference `fig:fsmerge' on page 131 undefined on input line 7710 . LaTeX Warning: Hyper reference `astAddFrame' on page 131 undefined on input lin e 7721. LaTeX Warning: Hyper reference `Mapping' on page 131 undefined on input line 77 21. LaTeX Warning: Hyper reference `Frame' on page 131 undefined on input line 7721 . LaTeX Warning: Hyper reference `astAddFrame' on page 131 undefined on input lin e 7721. LaTeX Warning: Hyper reference `Mapping' on page 131 undefined on input line 77 21. LaTeX Warning: Hyper reference `Frame' on page 131 undefined on input line 7721 . [131] LaTeX Warning: Reference `ss:addingframes' on page 132 undefined on input line 7730. LaTeX Warning: Reference `fig:fsmerge' on page 132 undefined on input line 7736 . [132 <./sun211_figures/fsmerge.pdf>] [133] [134] LaTeX Warning: Hyper reference `Object' on page 135 undefined on input line 776 8. LaTeX Warning: Hyper reference `Channel' on page 135 undefined on input line 77 83. LaTeX Warning: Hyper reference `XmlChan' on page 135 undefined on input line 77 85. LaTeX Warning: Reference `ss:xmlchan' on page 135 undefined on input line 7786. LaTeX Warning: Hyper reference `FitsChan' on page 135 undefined on input line 7 786. LaTeX Warning: Reference `ss:nativefits' on page 135 undefined on input line 77 86. LaTeX Warning: Hyper reference `Channel' on page 135 undefined on input line 77 90. LaTeX Warning: Reference `ss:creatingachannel' on page 135 undefined on input l ine 7801. LaTeX Warning: Hyper reference `Channel' on page 135 undefined on input line 78 05. LaTeX Warning: Hyper reference `astChannel' on page 135 undefined on input line 7806. LaTeX Warning: Reference `ss:channelsource' on page 135 undefined on input line 7822. LaTeX Warning: Reference `ss:channelsink' on page 135 undefined on input line 7 822. LaTeX Warning: Hyper reference `SinkFile' on page 135 undefined on input line 7 831. LaTeX Warning: Hyper reference `SourceFile' on page 135 undefined on input line 7831. [135] LaTeX Warning: Hyper reference `Object' on page 136 undefined on input line 783 8. LaTeX Warning: Hyper reference `Channel' on page 136 undefined on input line 78 38. LaTeX Warning: Hyper reference `astWrite' on page 136 undefined on input line 7 838. LaTeX Warning: Reference `ss:foreignfitslimitations' on page 136 undefined on i nput line 7863. LaTeX Warning: Reference `ss:writingtoachannel' on page 136 undefined on input line 7869. LaTeX Warning: Hyper reference `Object' on page 136 undefined on input line 787 0. LaTeX Warning: Hyper reference `SinkFile' on page 136 undefined on input line 7 872. LaTeX Warning: Hyper reference `astRead' on page 136 undefined on input line 78 82. LaTeX Warning: Hyper reference `Channel' on page 136 undefined on input line 78 83. LaTeX Warning: Hyper reference `Channel' on page 136 undefined on input line 79 09. LaTeX Warning: Hyper reference `Object' on page 136 undefined on input line 791 0. [136] LaTeX Warning: Hyper reference `astRead' on page 137 undefined on input line 79 21. LaTeX Warning: Hyper reference `astRead' on page 137 undefined on input line 79 26. LaTeX Warning: Reference `ss:readingfromachannel' on page 137 undefined on inpu t line 7926. LaTeX Warning: Hyper reference `Object' on page 137 undefined on input line 792 7. LaTeX Warning: Hyper reference `Frame' on page 137 undefined on input line 7929 . LaTeX Warning: Hyper reference `astIsA$<$Class$>$' on page 137 undefined on inp ut line 7930. LaTeX Warning: Hyper reference `SkyFrame' on page 137 undefined on input line 7 943. LaTeX Warning: Hyper reference `Class' on page 137 undefined on input line 7944 . LaTeX Warning: Hyper reference `Class' on page 137 undefined on input line 7963 . LaTeX Warning: Reference `ss:validatinginput' on page 137 undefined on input li ne 7965. LaTeX Warning: Hyper reference `Object' on page 137 undefined on input line 797 1. LaTeX Warning: Hyper reference `ID' on page 137 undefined on input line 7971. LaTeX Warning: Hyper reference `Ident' on page 137 undefined on input line 7971 . [137] LaTeX Warning: Hyper reference `Object' on page 138 undefined on input line 800 6. LaTeX Warning: Hyper reference `Channel' on page 138 undefined on input line 80 06. LaTeX Warning: Reference `ss:writingtoachannel' on page 138 undefined on input line 8007. LaTeX Warning: Hyper reference `SkyFrame' on page 138 undefined on input line 8 008. LaTeX Warning: Hyper reference `astShow' on page 138 undefined on input line 80 50. LaTeX Warning: Reference `ss:displayingobjects' on page 138 undefined on input line 8050. [138] LaTeX Warning: Hyper reference `astRead' on page 139 undefined on input line 80 63. LaTeX Warning: Reference `ss:classhierarchy' on page 139 undefined on input lin e 8085. LaTeX Warning: Hyper reference `Frame' on page 139 undefined on input line 8085 . LaTeX Warning: Hyper reference `astWrite' on page 139 undefined on input line 8 105. LaTeX Warning: Reference `ss:writingtoachannel' on page 139 undefined on input line 8106. LaTeX Warning: Hyper reference `Channel' on page 139 undefined on input line 81 06. LaTeX Warning: Hyper reference `Full' on page 139 undefined on input line 8110. LaTeX Warning: Reference `ss:textualoutputformat' on page 139 undefined on inpu t line 8113. [139] LaTeX Warning: Hyper reference `Object' on page 140 undefined on input line 814 7. LaTeX Warning: Hyper reference `SkyFrame' on page 140 undefined on input line 8 150. [140] LaTeX Warning: Hyper reference `Channel' on page 141 undefined on input line 82 30. LaTeX Warning: Hyper reference `Comment' on page 141 undefined on input line 82 31. [141] LaTeX Warning: Hyper reference `astWrite' on page 142 undefined on input line 8 265. LaTeX Warning: Hyper reference `astShow' on page 142 undefined on input line 82 66. LaTeX Warning: Hyper reference `Object' on page 142 undefined on input line 826 9. LaTeX Warning: Hyper reference `astRead' on page 142 undefined on input line 82 77. LaTeX Warning: Hyper reference `Frame' on page 142 undefined on input line 8296 . LaTeX Warning: Hyper reference `astRead' on page 142 undefined on input line 83 08. LaTeX Warning: Hyper reference `Channel' on page 142 undefined on input line 83 08. LaTeX Warning: Reference `ss:readingfromachannel' on page 142 undefined on inpu t line 8309. LaTeX Warning: Hyper reference `Object' on page 142 undefined on input line 831 2. [142] LaTeX Warning: Hyper reference `Skip' on page 143 undefined on input line 8319. LaTeX Warning: Hyper reference `astShow' on page 143 undefined on input line 83 27. LaTeX Warning: Hyper reference `Channel' on page 143 undefined on input line 83 49. LaTeX Warning: Hyper reference `SinkFile' on page 143 undefined on input line 8 354. LaTeX Warning: Hyper reference `SourceFile' on page 143 undefined on input line 8354. [143] LaTeX Warning: Hyper reference `astChannel' on page 144 undefined on input line 8385. LaTeX Warning: Reference `ss:creatingachannel' on page 144 undefined on input l ine 8386. LaTeX Warning: Hyper reference `Object' on page 144 undefined on input line 843 0. LaTeX Warning: Hyper reference `astRead' on page 144 undefined on input line 84 30. LaTeX Warning: Hyper reference `SinkFile' on page 144 undefined on input line 8 441. LaTeX Warning: Hyper reference `Channel' on page 144 undefined on input line 84 41. [144] LaTeX Warning: Reference `ss:channelsource' on page 145 undefined on input line 8463. LaTeX Warning: Hyper reference `astChannel' on page 145 undefined on input line 8478. LaTeX Warning: Hyper reference `astSetStatus' on page 145 undefined on input li ne 8508. LaTeX Warning: Reference `ss:errordetection' on page 145 undefined on input lin e 8508. LaTeX Warning: Hyper reference `astWrite' on page 145 undefined on input line 8 512. LaTeX Warning: Reference `ss:channelsource' on page 145 undefined on input line 8517. LaTeX Warning: Reference `ss:channelsink' on page 145 undefined on input line 8 518. LaTeX Warning: Hyper reference `Channel' on page 145 undefined on input line 85 18. [145] [146] LaTeX Warning: Hyper reference `System' on page 147 undefined on input line 853 8. LaTeX Warning: Hyper reference `Channel' on page 147 undefined on input line 85 55. LaTeX Warning: Hyper reference `FitsChan' on page 147 undefined on input line 8 555. LaTeX Warning: Reference `ss:channels' on page 147 undefined on input line 8558 . LaTeX Warning: Reference `ss:foreignfits' on page 147 undefined on input line 8 559. LaTeX Warning: Reference `ss:foreignfits' on page 147 undefined on input line 8 576. LaTeX Warning: Hyper reference `Channel' on page 147 undefined on input line 85 85. LaTeX Warning: Reference `ss:channels' on page 147 undefined on input line 8586 . LaTeX Warning: Hyper reference `Channel' on page 147 undefined on input line 85 93. LaTeX Warning: Hyper reference `FitsChan' on page 147 undefined on input line 8 593. LaTeX Warning: Hyper reference `astPutFits' on page 147 undefined on input line 8602. LaTeX Warning: Reference `ss:addingfitscards' on page 147 undefined on input li ne 8603. [147] LaTeX Warning: Hyper reference `astPutCards' on page 148 undefined on input lin e 8606. LaTeX Warning: Reference `ss:addingmulticards' on page 148 undefined on input l ine 8607. LaTeX Warning: Hyper reference `Object' on page 148 undefined on input line 860 9. LaTeX Warning: Hyper reference `astWrite' on page 148 undefined on input line 8 609. LaTeX Warning: Reference `ss:writingnativefits' on page 148 undefined on input line 8611. LaTeX Warning: Hyper reference `SourceFile' on page 148 undefined on input line 8613. LaTeX Warning: Hyper reference `astSet' on page 148 undefined on input line 861 6. LaTeX Warning: Reference `ss:channelsource' on page 148 undefined on input line 8622. LaTeX Warning: Reference `ss:fitssourceandsink' on page 148 undefined on input line 8624. LaTeX Warning: Hyper reference `astDelFits' on page 148 undefined on input line 8630. LaTeX Warning: Reference `ss:findingandchangingfits' on page 148 undefined on i nput line 8631. LaTeX Warning: Hyper reference `astRead' on page 148 undefined on input line 86 33. LaTeX Warning: Reference `ss:readingnativefits' on page 148 undefined on input line 8635. LaTeX Warning: Hyper reference `SinkFile' on page 148 undefined on input line 8 637. LaTeX Warning: Reference `ss:channelsink' on page 148 undefined on input line 8 643. LaTeX Warning: Reference `ss:fitssourceandsink' on page 148 undefined on input line 8645. LaTeX Warning: Reference `ss:destructiveread' on page 148 undefined on input li ne 8652. LaTeX Warning: Hyper reference `astFindFits' on page 148 undefined on input lin e 8655. LaTeX Warning: Reference `ss:findingandchangingfits' on page 148 undefined on i nput line 8660. LaTeX Warning: Hyper reference `FitsChan' on page 148 undefined on input line 8 664. LaTeX Warning: Hyper reference `astFitsChan' on page 148 undefined on input lin e 8664. [148] LaTeX Warning: Hyper reference `Encoding' on page 149 undefined on input line 8 680. LaTeX Warning: Reference `ss:nativeencoding' on page 149 undefined on input lin e 8682. LaTeX Warning: Hyper reference `FitsChan' on page 149 undefined on input line 8 690. LaTeX Warning: Hyper reference `Card' on page 149 undefined on input line 8695. LaTeX Warning: Hyper reference `Ncard' on page 149 undefined on input line 8725 . LaTeX Warning: Hyper reference `astFindFits' on page 149 undefined on input lin e 8745. LaTeX Warning: Reference `ss:extractingfitscards' on page 149 undefined on inpu t line 8746. LaTeX Warning: Reference `ss:findingandchangingfits' on page 149 undefined on i nput line 8747. [149] LaTeX Warning: Hyper reference `FitsChan' on page 150 undefined on input line 8 757. LaTeX Warning: Reference `ss:creatingafitschan' on page 150 undefined on input line 8757. LaTeX Warning: Hyper reference `Object' on page 150 undefined on input line 875 8. LaTeX Warning: Hyper reference `astWrite' on page 150 undefined on input line 8 759. LaTeX Warning: Hyper reference `SkyFrame' on page 150 undefined on input line 8 760. LaTeX Warning: Hyper reference `FrameSet' on page 150 undefined on input line 8 762. LaTeX Warning: Reference `ss:nativeencoding' on page 150 undefined on input lin e 8776. LaTeX Warning: Hyper reference `Channel' on page 150 undefined on input line 87 78. LaTeX Warning: Reference `ss:writingtoachannel' on page 150 undefined on input line 8779. LaTeX Warning: Hyper reference `Ncard' on page 150 undefined on input line 8783 . LaTeX Warning: Hyper reference `Card' on page 150 undefined on input line 8784. LaTeX Warning: Reference `ss:addressingfitscards' on page 150 undefined on inpu t line 8788. LaTeX Warning: Hyper reference `Frame' on page 150 undefined on input line 8793 . LaTeX Warning: Hyper reference `astPutFits' on page 150 undefined on input line 8804. LaTeX Warning: Hyper reference `astPutCards' on page 150 undefined on input lin e 8804. LaTeX Warning: Hyper reference `FitsChan' on page 150 undefined on input line 8 809. LaTeX Warning: Hyper reference `SkyFrame' on page 150 undefined on input line 8 809. LaTeX Warning: Reference `ss:writingnativefits' on page 150 undefined on input line 8810. LaTeX Warning: Hyper reference `astClear' on page 150 undefined on input line 8 812. [150] LaTeX Warning: Hyper reference `astFindFits' on page 151 undefined on input lin e 8827. LaTeX Warning: Hyper reference `Card' on page 151 undefined on input line 8830. LaTeX Warning: Reference `ss:fitssourceandsink' on page 151 undefined on input line 8839. LaTeX Warning: Hyper reference `SkyFrame' on page 151 undefined on input line 8 843. LaTeX Warning: Reference `ss:writingnativefits' on page 151 undefined on input line 8844. LaTeX Warning: Hyper reference `Channel' on page 151 undefined on input line 88 71. LaTeX Warning: Reference `ss:textualoutputformat' on page 151 undefined on inpu t line 8872. LaTeX Warning: Hyper reference `Full' on page 151 undefined on input line 8879. LaTeX Warning: Hyper reference `FitsChan' on page 151 undefined on input line 8 880. LaTeX Warning: Reference `ss:controllingchanneloutput' on page 151 undefined on input line 8881. [151] LaTeX Warning: Hyper reference `astWrite' on page 152 undefined on input line 8 899. LaTeX Warning: Hyper reference `Comment' on page 152 undefined on input line 89 12. LaTeX Warning: Reference `ss:channelcommenting' on page 152 undefined on input line 8913. LaTeX Warning: Hyper reference `FitsChan' on page 152 undefined on input line 8 918. LaTeX Warning: Hyper reference `astPutFits' on page 152 undefined on input line 8919. LaTeX Warning: Hyper reference `Card' on page 152 undefined on input line 8932. LaTeX Warning: Hyper reference `FitsChan' on page 152 undefined on input line 8 963. LaTeX Warning: Hyper reference `astPutCards' on page 152 undefined on input lin e 8964. LaTeX Warning: Hyper reference `astRead' on page 152 undefined on input line 89 68. LaTeX Warning: Hyper reference `astPutFits' on page 152 undefined on input line 8970. LaTeX Warning: Reference `ss:addingfitscards' on page 152 undefined on input li ne 8972. [152] LaTeX Warning: Hyper reference `Object' on page 153 undefined on input line 899 7. LaTeX Warning: Hyper reference `FitsChan' on page 153 undefined on input line 8 998. LaTeX Warning: Reference `ss:writingnativefits' on page 153 undefined on input line 8998. LaTeX Warning: Hyper reference `astRead' on page 153 undefined on input line 89 99. LaTeX Warning: Hyper reference `Channel' on page 153 undefined on input line 90 00. LaTeX Warning: Reference `ss:readingfromachannel' on page 153 undefined on inpu t line 9000. LaTeX Warning: Reference `ss:validatinginput' on page 153 undefined on input li ne 9002. LaTeX Warning: Hyper reference `astCopy' on page 153 undefined on input line 90 23. LaTeX Warning: Reference `ss:copyingobjects' on page 153 undefined on input lin e 9024. LaTeX Warning: Hyper reference `Card' on page 153 undefined on input line 9027. LaTeX Warning: Hyper reference `astWrite' on page 153 undefined on input line 9 034. LaTeX Warning: Hyper reference `FitsChan' on page 153 undefined on input line 9 042. LaTeX Warning: Hyper reference `Card' on page 153 undefined on input line 9043. LaTeX Warning: Hyper reference `Object' on page 153 undefined on input line 904 4. [153] LaTeX Warning: Reference `ss:readingnativefits' on page 154 undefined on input line 9048. LaTeX Warning: Hyper reference `Object' on page 154 undefined on input line 906 3. LaTeX Warning: Hyper reference `Skip' on page 154 undefined on input line 9067. LaTeX Warning: Hyper reference `FitsChan' on page 154 undefined on input line 9 067. LaTeX Warning: Hyper reference `Channel' on page 154 undefined on input line 90 75. LaTeX Warning: Reference `ss:mixingchanneltext' on page 154 undefined on input line 9075. LaTeX Warning: Hyper reference `FitsChan' on page 154 undefined on input line 9 080. LaTeX Warning: Hyper reference `astFindFits' on page 154 undefined on input lin e 9081. LaTeX Warning: Hyper reference `Card' on page 154 undefined on input line 9086. LaTeX Warning: Hyper reference `astPutFits' on page 154 undefined on input line 9111. [154] LaTeX Warning: Hyper reference `astDelFits' on page 155 undefined on input line 9117. LaTeX Warning: Reference `ss:functiondescriptions' on page 155 undefined on inp ut line 9142. LaTeX Warning: Hyper reference `FitsChan' on page 155 undefined on input line 9 146. LaTeX Warning: Reference `ss:addingfitscards' on page 155 undefined on input li ne 9148. LaTeX Warning: Reference `ss:addingmulticards' on page 155 undefined on input l ine 9148. LaTeX Warning: Reference `ss:extractingfitscards' on page 155 undefined on inpu t line 9151. LaTeX Warning: Hyper reference `Channel' on page 155 undefined on input line 91 54. LaTeX Warning: Reference `ss:channelsource' on page 155 undefined on input line 9154. LaTeX Warning: Reference `ss:channelsink' on page 155 undefined on input line 9 155. LaTeX Warning: Hyper reference `astFitsChan' on page 155 undefined on input lin e 9156. LaTeX Warning: Reference `ss:creatingafitschan' on page 155 undefined on input line 9157. LaTeX Warning: Reference `ss:channelsource' on page 155 undefined on input line 9167. LaTeX Warning: Reference `ss:channelsink' on page 155 undefined on input line 9 168. [155] [156] LaTeX Warning: Reference `ss:nativefits' on page 157 undefined on input line 91 79. LaTeX Warning: Hyper reference `Object' on page 157 undefined on input line 918 0. LaTeX Warning: Hyper reference `FitsChan' on page 157 undefined on input line 9 181. LaTeX Warning: Hyper reference `Encoding' on page 157 undefined on input line 9 181. LaTeX Warning: Reference `ss:nativeencoding' on page 157 undefined on input lin e 9194. LaTeX Warning: Hyper reference `Encoding' on page 157 undefined on input line 9 201. LaTeX Warning: Hyper reference `FitsChan' on page 157 undefined on input line 9 201. LaTeX Warning: Reference `ss:fitswcscoverage' on page 157 undefined on input li ne 9234. [157] LaTeX Warning: Reference `ss:attributedescriptions' on page 158 undefined on in put line 9275. LaTeX Warning: Reference `ss:nativefits' on page 158 undefined on input line 92 81. LaTeX Warning: Hyper reference `Object' on page 158 undefined on input line 928 4. LaTeX Warning: Hyper reference `FrameSet' on page 158 undefined on input line 9 284. LaTeX Warning: Reference `ss:baseandcurrent' on page 158 undefined on input lin e 9289. LaTeX Warning: Hyper reference `Frame' on page 158 undefined on input line 9293 . LaTeX Warning: Hyper reference `FitsChan' on page 158 undefined on input line 9 301. [158] LaTeX Warning: Hyper reference `Encoding' on page 159 undefined on input line 9 313. LaTeX Warning: Reference `ss:attributedescriptions' on page 159 undefined on in put line 9314. [159] LaTeX Warning: Hyper reference `FitsChan' on page 160 undefined on input line 9 377. LaTeX Warning: Hyper reference `Encoding' on page 160 undefined on input line 9 397. LaTeX Warning: Reference `ss:creatingafitschan' on page 160 undefined on input line 9398. LaTeX Warning: Reference `ss:attributedescriptions' on page 160 undefined on in put line 9405. LaTeX Warning: Reference `ss:readingforeignfits' on page 160 undefined on input line 9439. LaTeX Warning: Hyper reference `FitsChan' on page 160 undefined on input line 9 447. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 160 undefined on input line 9449. LaTeX Warning: Hyper reference `Object' on page 160 undefined on input line 945 0. LaTeX Warning: Hyper reference `astRead' on page 160 undefined on input line 94 50. LaTeX Warning: Hyper reference `Card' on page 160 undefined on input line 9451. [160] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 161 undefined on input line 9468. LaTeX Warning: Reference `ss:validatinginput' on page 161 undefined on input li ne 9471. LaTeX Warning: Hyper reference `FrameSet' on page 161 undefined on input line 9 484. LaTeX Warning: Reference `ss:foreignfitslimitations' on page 161 undefined on i nput line 9484. LaTeX Warning: Reference `ss:nativeencoding' on page 161 undefined on input lin e 9486. LaTeX Warning: Hyper reference `Encoding' on page 161 undefined on input line 9 487. LaTeX Warning: Hyper reference `astShow' on page 161 undefined on input line 94 91. LaTeX Warning: Reference `ss:displayingobjects' on page 161 undefined on input line 9491. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 161 undefined on input line 9493. LaTeX Warning: Hyper reference `Frame' on page 161 undefined on input line 9494 . LaTeX Warning: Hyper reference `SkyFrame' on page 161 undefined on input line 9 495. LaTeX Warning: Hyper reference `Mapping' on page 161 undefined on input line 94 96. LaTeX Warning: Hyper reference `CmpMap' on page 161 undefined on input line 949 6. LaTeX Warning: Reference `ss:framesetasmapping' on page 161 undefined on input line 9503. LaTeX Warning: Reference `ss:framesetasframe' on page 161 undefined on input li ne 9504. LaTeX Warning: Reference `ss:framesetasmapping' on page 161 undefined on input line 9510. LaTeX Warning: Reference `ss:formattingaxisvalues' on page 161 undefined on inp ut line 9514. LaTeX Warning: Reference `ss:normalising' on page 161 undefined on input line 9 514. LaTeX Warning: Reference `ss:frameattributes' on page 161 undefined on input li ne 9517. LaTeX Warning: Reference `ss:frameaxisattributes' on page 161 undefined on inpu t line 9519. LaTeX Warning: Reference `ss:registeringimages' on page 161 undefined on input line 9522. LaTeX Warning: Hyper reference `Plot' on page 161 undefined on input line 9524. LaTeX Warning: Reference `ss:plots' on page 161 undefined on input line 9524. LaTeX Warning: Reference `fig:gridplot' on page 161 undefined on input line 952 6. [161] LaTeX Warning: Reference `ss:wcsprocessingexample' on page 162 undefined on inp ut line 9530. LaTeX Warning: Reference `ss:writingforeignfits' on page 162 undefined on input line 9532. LaTeX Warning: Hyper reference `FitsChan' on page 162 undefined on input line 9 541. LaTeX Warning: Hyper reference `FrameSet' on page 162 undefined on input line 9 542. LaTeX Warning: Reference `ss:readingforeignfits' on page 162 undefined on input line 9543. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 162 undefined on input line 9559. LaTeX Warning: Hyper reference `astRead' on page 162 undefined on input line 95 85. LaTeX Warning: Reference `ss:writingforeignfits' on page 162 undefined on input line 9588. [162] LaTeX Warning: Reference `ss:writingforeignfits' on page 163 undefined on input line 9601. LaTeX Warning: Hyper reference `FitsChan' on page 163 undefined on input line 9 633. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 163 undefined on input line 9634. LaTeX Warning: Hyper reference `Object' on page 163 undefined on input line 963 6. LaTeX Warning: Hyper reference `FrameSet' on page 163 undefined on input line 9 636. LaTeX Warning: Reference `ss:readingforeignfits' on page 163 undefined on input line 9637. LaTeX Warning: Reference `ss:wcsprocessingexample' on page 163 undefined on inp ut line 9640. LaTeX Warning: Reference `ss:writingforeignfits' on page 163 undefined on input line 9643. LaTeX Warning: Reference `ss:writingforeignfits' on page 163 undefined on input line 9655. LaTeX Warning: Hyper reference `FrameSet' on page 163 undefined on input line 9 659. LaTeX Warning: Hyper reference `FitsChan' on page 163 undefined on input line 9 660. LaTeX Warning: Hyper reference `Encoding' on page 163 undefined on input line 9 662. LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 163 undefined on input line 9663. LaTeX Warning: Reference `ss:destructiveread' on page 163 undefined on input li ne 9665. [163] LaTeX Warning: Reference `ss:identifyingfitsencoding' on page 164 undefined on input line 9673. LaTeX Warning: Hyper reference `Card' on page 164 undefined on input line 9674. LaTeX Warning: Hyper reference `astWrite' on page 164 undefined on input line 9 676. [164] [165] [166] LaTeX Warning: Hyper reference `XmlChan' on page 167 undefined on input line 97 73. LaTeX Warning: Hyper reference `Channel' on page 167 undefined on input line 97 73. LaTeX Warning: Hyper reference `Frame' on page 167 undefined on input line 9781 . LaTeX Warning: Hyper reference `Full' on page 167 undefined on input line 9781. LaTeX Warning: Hyper reference `Title' on page 167 undefined on input line 9834 . [167] Overfull \hbox (135.00621pt too wide) in paragraph at lines 9848--9851 []\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 168 undefined on input line 98 55. LaTeX Warning: Hyper reference `Skip' on page 168 undefined on input line 9873. LaTeX Warning: Hyper reference `Object' on page 168 undefined on input line 987 5. LaTeX Warning: Hyper reference `XmlChan' on page 168 undefined on input line 98 81. LaTeX Warning: Reference `ss:stcschans' on page 168 undefined on input line 988 7. LaTeX Warning: Hyper reference `Object' on page 168 undefined on input line 989 5. LaTeX Warning: Hyper reference `Stc' on page 168 undefined on input line 9895. LaTeX Warning: Hyper reference `Region' on page 168 undefined on input line 989 6. LaTeX Warning: Hyper reference `StcSearchLocation' on page 168 undefined on inp ut line 9897. LaTeX Warning: Hyper reference `StcResourceProfile' on page 168 undefined on in put line 9897. LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 168 undefined on input line 9897. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 168 undefined on in put line 9898. LaTeX Warning: Hyper reference `XmlFormat' on page 168 undefined on input line 9899. [168] [169] [170] LaTeX Warning: Hyper reference `StcsChan' on page 171 undefined on input line 9 904. LaTeX Warning: Hyper reference `Region' on page 171 undefined on input line 991 1. LaTeX Warning: Reference `ss:classdescriptions' on page 171 undefined on input line 9913. [171] [172] LaTeX Warning: Hyper reference `Mapping' on page 173 undefined on input line 99 20. LaTeX Warning: Hyper reference `IntraMap' on page 173 undefined on input line 9 943. LaTeX Warning: Hyper reference `Mapping' on page 173 undefined on input line 99 48. LaTeX Warning: Hyper reference `IntraMap' on page 173 undefined on input line 9 948. LaTeX Warning: Hyper reference `CmpMap' on page 173 undefined on input line 995 7. LaTeX Warning: Reference `ss:cmpmaps' on page 173 undefined on input line 9957. LaTeX Warning: Reference `ss:invertingmappings' on page 173 undefined on input line 9958. LaTeX Warning: Reference `ss:gettingattributes' on page 173 undefined on input line 9959. LaTeX Warning: Reference `ss:framesets' on page 173 undefined on input line 996 0. LaTeX Warning: Hyper reference `Mapping' on page 173 undefined on input line 99 66. LaTeX Warning: Hyper reference `IntraMap' on page 173 undefined on input line 9 977. [173] LaTeX Warning: Hyper reference `IntraMap' on page 174 undefined on input line 1 0002. LaTeX Warning: Hyper reference `astTranP' on page 174 undefined on input line 1 0004. [174] LaTeX Warning: Reference `ss:badcoordinates' on page 175 undefined on input lin e 10057. LaTeX Warning: Hyper reference `Mapping' on page 175 undefined on input line 10 075. LaTeX Warning: Hyper reference `astSetStatus' on page 175 undefined on input li ne 10078. LaTeX Warning: Reference `ss:errordetection' on page 175 undefined on input lin e 10078. LaTeX Warning: Hyper reference `astIntraReg' on page 175 undefined on input lin e 10089. LaTeX Warning: Hyper reference `IntraMap' on page 175 undefined on input line 1 0113. [175] LaTeX Warning: Hyper reference `Nin' on page 176 undefined on input line 10120. LaTeX Warning: Hyper reference `Nout' on page 176 undefined on input line 10120 . LaTeX Warning: Reference `ss:variableintramapcoordinates' on page 176 undefined on input line 10125. LaTeX Warning: Reference `ss:restrictedintramaps' on page 176 undefined on inpu t line 10130. LaTeX Warning: Reference `ss:simplifyingintramaps' on page 176 undefined on inp ut line 10131. LaTeX Warning: Reference `ss:intramaplimitations' on page 176 undefined on inpu t line 10137. LaTeX Warning: Hyper reference `IntraMap' on page 176 undefined on input line 1 0157. LaTeX Warning: Hyper reference `astIntraMap' on page 176 undefined on input lin e 10169. LaTeX Warning: Hyper reference `astIntraReg' on page 176 undefined on input lin e 10172. LaTeX Warning: Reference `ss:registeringintramaps' on page 176 undefined on inp ut line 10172. LaTeX Warning: Hyper reference `Nin' on page 176 undefined on input line 10184. LaTeX Warning: Hyper reference `Nout' on page 176 undefined on input line 10184 . LaTeX Warning: Hyper reference `Mapping' on page 176 undefined on input line 10 190. LaTeX Warning: Reference `ss:settingattributes' on page 176 undefined on input line 10190. LaTeX Warning: Reference `ss:intraflag' on page 176 undefined on input line 101 91. [176] LaTeX Warning: Hyper reference `IntraMap' on page 177 undefined on input line 1 0196. LaTeX Warning: Hyper reference `astIntraReg' on page 177 undefined on input lin e 10221. LaTeX Warning: Reference `ss:transformationfunctions' on page 177 undefined on input line 10246. [177] LaTeX Warning: Hyper reference `IntraMap' on page 178 undefined on input line 1 0258. LaTeX Warning: Hyper reference `astIntraReg' on page 178 undefined on input lin e 10273. LaTeX Warning: Hyper reference `Nin' on page 178 undefined on input line 10274. LaTeX Warning: Hyper reference `Nout' on page 178 undefined on input line 10275 . LaTeX Warning: Hyper reference `IntraMap' on page 178 undefined on input line 1 0293. LaTeX Warning: Hyper reference `IntraFlag' on page 178 undefined on input line 10300. LaTeX Warning: Hyper reference `Mapping' on page 178 undefined on input line 10 328. [178] LaTeX Warning: Hyper reference `astSimplify' on page 179 undefined on input lin e 10336. LaTeX Warning: Reference `ss:simplifyingcmpmaps' on page 179 undefined on input line 10336. LaTeX Warning: Hyper reference `Mapping' on page 179 undefined on input line 10 342. LaTeX Warning: Hyper reference `UnitMap' on page 179 undefined on input line 10 343. [179] LaTeX Warning: Hyper reference `astIntraReg' on page 180 undefined on input lin e 10405. LaTeX Warning: Reference `ss:transformationfunctions' on page 180 undefined on input line 10425. LaTeX Warning: Reference `ss:transformationfunctions' on page 180 undefined on input line 10430. LaTeX Warning: Hyper reference `IntraMap' on page 180 undefined on input line 1 0442. LaTeX Warning: Hyper reference `IntraMap' on page 180 undefined on input line 1 0446. LaTeX Warning: Hyper reference `Channel' on page 180 undefined on input line 10 447. LaTeX Warning: Reference `ss:writingtoachannel' on page 180 undefined on input line 10447. LaTeX Warning: Reference `ss:readingfromachannel' on page 180 undefined on inpu t line 10456. [180] LaTeX Warning: Reference `ss:intramaplibrary' on page 181 undefined on input li ne 10472. LaTeX Warning: Reference `ss:intramaplimitations' on page 181 undefined on inpu t line 10475. LaTeX Warning: Hyper reference `astIntraReg' on page 181 undefined on input lin e 10490. LaTeX Warning: Hyper reference `Object' on page 181 undefined on input line 105 23. LaTeX Warning: Hyper reference `IntraMap' on page 181 undefined on input line 1 0524. LaTeX Warning: Reference `ss:readingandwritingintramaps' on page 181 undefined on input line 10525. [181] [182] LaTeX Warning: Hyper reference `Object' on page 183 undefined on input line 105 32. LaTeX Warning: Hyper reference `Plot' on page 183 undefined on input line 10532 . LaTeX Warning: Hyper reference `FrameSet' on page 183 undefined on input line 1 0533. LaTeX Warning: Hyper reference `Plot' on page 183 undefined on input line 10540 . LaTeX Warning: Hyper reference `FrameSet' on page 183 undefined on input line 1 0540. LaTeX Warning: Hyper reference `Frame' on page 183 undefined on input line 1054 1. LaTeX Warning: Hyper reference `Base' on page 183 undefined on input line 10541 . LaTeX Warning: Hyper reference `Mapping' on page 183 undefined on input line 10 553. LaTeX Warning: Hyper reference `astMark' on page 183 undefined on input line 10 584. [183] LaTeX Warning: Hyper reference `Plot' on page 184 undefined on input line 10611 . LaTeX Warning: Hyper reference `Frame' on page 184 undefined on input line 1061 9. LaTeX Warning: Hyper reference `astDistance' on page 184 undefined on input lin e 10621. LaTeX Warning: Hyper reference `astCurve' on page 184 undefined on input line 1 0624. LaTeX Warning: Hyper reference `astOffset' on page 184 undefined on input line 10637. LaTeX Warning: Reference `ss:distanceandoffset' on page 184 undefined on input line 10639. LaTeX Warning: Hyper reference `astPolyCurve' on page 184 undefined on input li ne 10643. LaTeX Warning: Hyper reference `Plot' on page 184 undefined on input line 10666 . LaTeX Warning: Hyper reference `astCurve' on page 184 undefined on input line 1 0669. LaTeX Warning: Hyper reference `astPolyCurve' on page 184 undefined on input li ne 10669. LaTeX Warning: Reference `ss:plottinggeodesics' on page 184 undefined on input line 10670. [184] LaTeX Warning: Hyper reference `astGridLine' on page 185 undefined on input lin e 10675. LaTeX Warning: Hyper reference `Plot' on page 185 undefined on input line 10694 . LaTeX Warning: Hyper reference `astGenCurve' on page 185 undefined on input lin e 10696. LaTeX Warning: Hyper reference `Mapping' on page 185 undefined on input line 10 698. LaTeX Warning: Hyper reference `Frame' on page 185 undefined on input line 1070 1. LaTeX Warning: Hyper reference `IntraMap' on page 185 undefined on input line 1 0710. LaTeX Warning: Hyper reference `Plot' on page 185 undefined on input line 10716 . LaTeX Warning: Hyper reference `Frame' on page 185 undefined on input line 1073 0. [185] LaTeX Warning: Hyper reference `astClip' on page 186 undefined on input line 10 738. LaTeX Warning: Hyper reference `Plot' on page 186 undefined on input line 10763 . LaTeX Warning: Hyper reference `FrameSet' on page 186 undefined on input line 1 0778. LaTeX Warning: Hyper reference `astClip' on page 186 undefined on input line 10 781. LaTeX Warning: Reference `ss:clipping' on page 186 undefined on input line 1078 1. LaTeX Warning: Hyper reference `Mapping' on page 186 undefined on input line 10 784. LaTeX Warning: Hyper reference `astGetMapping' on page 186 undefined on input l ine 10785. LaTeX Warning: Hyper reference `Plot' on page 186 undefined on input line 10790 . LaTeX Warning: Hyper reference `Frame' on page 186 undefined on input line 1079 0. LaTeX Warning: Hyper reference `Title' on page 186 undefined on input line 1079 1. LaTeX Warning: Hyper reference `FrameSet' on page 186 undefined on input line 1 0793. LaTeX Warning: Reference `ss:framesetasframe' on page 186 undefined on input li ne 10794. LaTeX Warning: Reference `ss:plottingagrid' on page 186 undefined on input line 10797. LaTeX Warning: Hyper reference `astDistance' on page 186 undefined on input lin e 10801. LaTeX Warning: Hyper reference `astOffset' on page 186 undefined on input line 10801. LaTeX Warning: Hyper reference `astFormat' on page 186 undefined on input line 10803. LaTeX Warning: Hyper reference `astNorm' on page 186 undefined on input line 10 803. [186] LaTeX Warning: Hyper reference `Plot' on page 187 undefined on input line 10808 . LaTeX Warning: Reference `ss:clipping' on page 187 undefined on input line 1081 1. LaTeX Warning: Reference `ss:badcoordinates' on page 187 undefined on input lin e 10813. LaTeX Warning: Hyper reference `astBorder' on page 187 undefined on input line 10832. LaTeX Warning: Hyper reference `Plot' on page 187 undefined on input line 10834 . LaTeX Warning: Reference `ss:validphysicalcoordinates' on page 187 undefined on input line 10836. LaTeX Warning: Hyper reference `Plot' on page 187 undefined on input line 10863 . [187] LaTeX Warning: Hyper reference `astText' on page 188 undefined on input line 10 871. LaTeX Warning: Reference `ss:escapes' on page 188 undefined on input line 10895 . LaTeX Warning: Hyper reference `astGrid' on page 188 undefined on input line 10 899. LaTeX Warning: Reference `fig:gridplot' on page 188 undefined on input line 109 02. LaTeX Warning: Hyper reference `Plot' on page 188 undefined on input line 10903 . LaTeX Warning: Hyper reference `Frame' on page 188 undefined on input line 1091 4. LaTeX Warning: Hyper reference `Title' on page 188 undefined on input line 1091 5. LaTeX Warning: Reference `ss:escapes' on page 188 undefined on input line 10918 . LaTeX Warning: Hyper reference `Plot' on page 188 undefined on input line 10921 . LaTeX Warning: Hyper reference `Escape' on page 188 undefined on input line 109 25. LaTeX Warning: Reference `ss:attributedescriptions' on page 188 undefined on in put line 10929. LaTeX Warning: Hyper reference `astText' on page 188 undefined on input line 10 940. [188] LaTeX Warning: Hyper reference `SkyAxis' on page 189 undefined on input line 10 942. LaTeX Warning: Hyper reference `Plot' on page 189 undefined on input line 10958 . LaTeX Warning: Hyper reference `Mapping' on page 189 undefined on input line 10 965. LaTeX Warning: Hyper reference `Frame' on page 189 undefined on input line 1096 5. LaTeX Warning: Hyper reference `FrameSet' on page 189 undefined on input line 1 0967. LaTeX Warning: Hyper reference `Plot' on page 189 undefined on input line 11005 . [189] LaTeX Warning: Hyper reference `ast_link' on page 190 undefined on input line 1 1024. LaTeX Warning: Reference `ss:howtobuild' on page 190 undefined on input line 11 025. LaTeX Warning: Reference `ss:commanddescriptions' on page 190 undefined on inpu t line 11025. LaTeX Warning: Hyper reference `astGrfSet' on page 190 undefined on input line 11031. [190] LaTeX Warning: Reference `ss:commanddescriptions' on page 191 undefined on inpu t line 11049. LaTeX Warning: Hyper reference `ast_link' on page 191 undefined on input line 1 1091. [191] LaTeX Warning: Reference `ss:commanddescriptions' on page 192 undefined on inpu t line 11129. LaTeX Warning: Hyper reference `ast_link_adam' on page 192 undefined on input l ine 11138. LaTeX Warning: Hyper reference `ast_link' on page 192 undefined on input line 1 1156. LaTeX Warning: Reference `ss:linking' on page 192 undefined on input line 11156 . LaTeX Warning: Reference `ss:commanddescriptions' on page 192 undefined on inpu t line 11159. [192] LaTeX Warning: Reference `ss:classdescriptions' on page 193 undefined on input line 11166. [193] [194] [195] LaTeX Warning: Hyper reference `Object' on page 196 undefined on input line 113 44. Overfull \hbox (10.86975pt too wide) in paragraph at lines 11344--11344 \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 11344--11344 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " LaTeX Warning: Hyper reference `Report' on page 196 undefined on input line 113 44. LaTeX Warning: Hyper reference `Zoom' on page 196 undefined on input line 11344 . Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 196 undefined on input lin e 11344. Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 196 undefined on input line 1134 4. Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 11344--11344 [][]\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 11344--11344 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [196] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11344--11344 [][]\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 11344--11344 \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 11344--11344 \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 11344--11344 [][]\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 11344--11344 \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 11344--11344 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [197] LaTeX Warning: Hyper reference `KeyMap' on page 198 undefined on input line 114 25. LaTeX Warning: Hyper reference `Object' on page 198 undefined on input line 114 25. LaTeX Warning: Hyper reference `FrameSet' on page 198 undefined on input line 1 1425. LaTeX Warning: Hyper reference `SkyFrame' on page 198 undefined on input line 1 1425. LaTeX Warning: Hyper reference `ZoomMap' on page 198 undefined on input line 11 425. Overfull \hbox (28.19052pt too wide) in paragraph at lines 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \T1/cmtt/m/n/10 not returned. Otherwise they are returned. The supplied " subcl ass" value is LaTeX Warning: Hyper reference `astBegin' on page 198 undefined on input line 1 1425. LaTeX Warning: Hyper reference `astEnd' on page 198 undefined on input line 114 25. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11425--11425 \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 11425--11425 \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 11425--11425 Overfull \hbox (12.49844pt too wide) in paragraph at lines 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 []\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 11425--11425 [][]\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 11425--11425 [][]\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 11425--11425 [][]\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 11425--11425 \T1/cmtt/m/n/10 value and will have a routine name equal to the upper case Fort ran routine that [198] LaTeX Warning: Hyper reference `Moc' on page 199 undefined on input line 11484. Overfull \hbox (26.6159pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 Indicates how the Moc and specified cell are to be combined. An y of the following Overfull \hbox (41.84367pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__AND: If the specified cell is included in the Moc, it is removed. Otherwise Overfull \hbox (47.09239pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__OR: If the specified cell is not included in the Moc, it is added. Otherwise Overfull \hbox (46.82996pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__XOR: The specified cell is toggled - it is removed fro m the Moc if originally LaTeX Warning: Hyper reference `MaxOrder' on page 199 undefined on input line 1 1484. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 The HEALPix order of the cell. An error is reported if this is higher than the Overfull \hbox (0.37231pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 maximum order allowed in the Moc (as given by its MaxOrder attr ibute). If no Overfull \hbox (10.60732pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 value has been set for the MaxOrder attribute, calling this met hod causes it to Overfull \hbox (5.3586pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 be set to the supplied order value. So the highest order cells should usually Overfull \hbox (10.34488pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 The " npix" value identifying the required cell (see the MOC re commendation for [199] LaTeX Warning: Hyper reference `KeyMap' on page 200 undefined on input line 115 78. Overfull \hbox (5.52135pt too wide) in paragraph at lines 11578--11578 []\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 200 undefined on input line 1157 8. Overfull \hbox (17.43065pt too wide) in paragraph at lines 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 200 undefined on input line 115 78. LaTeX Warning: Hyper reference `astMapPutU' on page 200 undefined on input line 11578. Overfull \hbox (41.62883pt too wide) in paragraph at lines 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 200 undefined on input line 11578. Overfull \hbox (12.76088pt too wide) in paragraph at lines 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 [][]\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 11578--11578 \T1/cmtt/m/n/10 the supplied name and properties. However an error is reported if any of the [200] LaTeX Warning: Hyper reference `Frame' on page 201 undefined on input line 1169 6. LaTeX Warning: Hyper reference `Mapping' on page 201 undefined on input line 11 696. LaTeX Warning: Hyper reference `FrameSet' on page 201 undefined on input line 1 1696. Overfull \hbox (7.09596pt too wide) in paragraph at lines 11696--11696 []\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 201 undefined on input line 116 96. Overfull \hbox (15.85603pt too wide) in paragraph at lines 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 []\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 11696--11696 [][]\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 11696--11696 \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 11696--11696 [][]\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 201 undefined on input line 11 696. Overfull \hbox (5.62103pt too wide) in paragraph at lines 11696--11696 [][]\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 201 undefined on input line 11696. LaTeX Warning: Hyper reference `Nout' on page 201 undefined on input line 11696 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \T1/cmtt/m/n/10 the " frame" FrameSet. This latter Frame becomes the current Fr ame in the merged [201] LaTeX Warning: Hyper reference `CmpFrame' on page 202 undefined on input line 1 1696. LaTeX Warning: Hyper reference `CmpMap' on page 202 undefined on input line 116 96. LaTeX Warning: Hyper reference `UnitMap' on page 202 undefined on input line 11 696. LaTeX Warning: Hyper reference `astSimplify' on page 202 undefined on input lin e 11696. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \T1/cmtt/m/n/10 in the supplied Frame. Each new CmpMap is simplified using astS implify before [202] LaTeX Warning: Hyper reference `Moc' on page 203 undefined on input line 11801. Overfull \hbox (7.72334pt too wide) in paragraph at lines 11801--11801 []\T1/cmtt/m/n/10 void astAddMocData( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, int cmode, int negate, int maxorder, int len, int Overfull \hbox (10.86975pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 Indicates how the Moc and data are to be combined. Any of the f ollowing values Overfull \hbox (5.10265pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 If non-zero, the cells added to the Moc will be those included in the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 data array. If zero, the cells added to the Moc will be those n ot included in LaTeX Warning: Hyper reference `MaxOrder' on page 203 undefined on input line 1 1801. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The maximum HEALPix order to use. If a negative value is suppli ed, the maximum Overfull \hbox (17.69308pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 order will be determined by searching the data array (this will take extra time). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 In either case, if a value has already been set for the MaxOrde r attribute in Overfull \hbox (0.37231pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 the Moc, then the attribute value is used in preference to the value supplied Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 for this parameter. Any HEALPix cells in the data array that re fer to an order Overfull \hbox (15.85603pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The length of the supplied array (i.e. the number of 4 or 8 byt e integer values Overfull \hbox (10.86975pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 it contains). Note, this class only supports binary MOCs with l engths that can Overfull \hbox (0.10988pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The number of bytes in each integer value stored in the supplie d array. Must Overfull \hbox (21.36719pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 Pointer to the data array holding a description of a MOC in the form used by FITS Overfull \hbox (16.11847pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 binary tables. See the IVOA MOC recommendation for details. The values in this Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 array are signed integers, each with the number of bytes specif ied by parameter Overfull \hbox (0.5835pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 " nbyte" . The number of bytes in this array should be at least " len$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nbyte" Overfull \hbox (68.34322pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 set it to the value supplied for " Maxorder" , or to the larges t order present [203] [204] LaTeX Warning: Hyper reference `Moc' on page 205 undefined on input line 11906. Overfull \hbox (10.3477pt too wide) in paragraph at lines 11906--11906 []\T1/cmtt/m/n/10 void astAddMocString( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int cmode, int negate, int maxorder, size_t len, Overfull \hbox (10.86975pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Indicates how the supplied MOC is to be combined with the exist ing Moc. Any of Overfull \hbox (5.10265pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the supplied Overfull \hbox (10.35136pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 If non-zero, the cells added to the existing Moc will be those included in the Overfull \hbox (42.36206pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 supplied MOC. If zero, the cells added to the existing Moc will be those not included LaTeX Warning: Hyper reference `MaxOrder' on page 205 undefined on input line 1 1906. Overfull \hbox (10.60732pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The maximum HEALPix order to use. If a negative value is suppli ed, the maximum Overfull \hbox (28.19052pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 order will be determined by searching the supplied MOC (this wi ll take extra time). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 In either case, if a value has already been set for the MaxOrde r attribute in Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 the Moc, then the attribute value is used in preference to the value supplied Overfull \hbox (21.10475pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 for this parameter. Any HEALPix cells in the supplied MOC that refer to an order Overfull \hbox (5.09616pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The number of characters to read from the supplied string. If t his is greater Overfull \hbox (21.36719pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Pointer to the array of characters holding the supplied MOC. It should be encoded Overfull \hbox (22.9418pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 using either the string or JSON serialisation described in the MOC recommendation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The used serialisation is determined from the first non-blank c haracter, which Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 should be either a curly brace (' {' - JSON serialisation) or a digit (string Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Pointer to an int in which to return a boolean flag indicating if the supplied Overfull \hbox (12.44437pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 string was interpreted using the JSON (non-zero) or string (zer o) serialisation. Underfull \hbox (badness 10000) in paragraph at lines 11906--11906 [205] Overfull \hbox (68.34322pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 set it to the value supplied for " Maxorder" , or to the larges t order present [206] LaTeX Warning: Hyper reference `KeyMap' on page 207 undefined on input line 119 42. LaTeX Warning: Hyper reference `Table' on page 207 undefined on input line 1194 2. Overfull \hbox (33.1768pt too wide) in paragraph at lines 11942--11942 \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 11942--11942 [][]\T1/cmtt/m/n/10 Unlike columns, the definition of a parameter does not spec ify its type, size [207] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. LaTeX Warning: Hyper reference `Moc' on page 208 undefined on input line 12193. LaTeX Warning: Hyper reference `FrameSet' on page 208 undefined on input line 1 2193. LaTeX Warning: Hyper reference `Frame' on page 208 undefined on input line 1219 3. LaTeX Warning: Hyper reference `SkyFrame' on page 208 undefined on input line 1 2193. LaTeX Warning: Hyper reference `CmpFrame' on page 208 undefined on input line 1 2193. LaTeX Warning: Hyper reference `MinOrder' on page 208 undefined on input line 1 2193. LaTeX Warning: Hyper reference `MaxOrder' on page 208 undefined on input line 1 2193. Overfull \hbox (12.46611pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 void astAddPixelMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\O ML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, int cmode, AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 wcs, $\OML /zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 valu e, Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Indicates how the Moc and select pixels are to be combined. Any of the following Overfull \hbox (5.10265pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the selected Overfull \hbox (10.35136pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (10.86975pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Pointer to a FrameSet defining the World Coordinate Systems ass ociated with the Overfull \hbox (28.19052pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 image. The current Frame should be a SkyFrame or a CmpFrame con taining a SkyFrame. Overfull \hbox (26.35347pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The base Frame should have the same number of axes as the curre nt Frame and should Overfull \hbox (37.11334pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 represent " grid" coordinates within a pixel array (i.e. the fi rst pixel is centred Overfull \hbox (1.94693pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 at (1.0,1.0,...) and the distance between pixel centres is 1.0 on both axes). Overfull \hbox (15.85603pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The array supplied for parameter " array" is assumed to be a 2- dimensional slice [208] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the requ ired pixels. It Overfull \hbox (5.3586pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (42.36206pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 control over the operation. See the " Control Flags" section be low for a description Overfull \hbox (26.6159pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 of the options available. If no flag values are to be set, a va lue of zero should Overfull \hbox (10.60732pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 This parameter should have the same type as the elements of the data array. It Overfull \hbox (26.35347pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels). Suc h pixels are never Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Pointer to the 2-dimensional data array. The numerical type of this array should Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 match the 1- or 2-character type code appended to the function name (e.g. if Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 you are using astAddPixelMaskF, the type of each array element should be " float" Overfull \hbox (15.85603pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (12.44437pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 first grid dimension varies most rapidly (i.e. Fortran array in dexing is used). Overfull \hbox (23.25832pt too wide) in paragraph at lines 12193--12193 []\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 (28.50703pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 additional control over the process. Having selected a set of f lags, you should supply Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array which must Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 be recognised by comparing with the value given for " badval" . If this flag Overfull \hbox (3.21706pt too wide) in paragraph at lines 12193--12193 []\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 12193--12193 \T1/cmtt/m/n/10 function name astAddPixelMask$\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 co de, so as to [209] Overfull \hbox (60.26178pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 For example, astAddPixelMaskD would be used to process " double " data, while astAddPixelMaskS Overfull \hbox (28.76947pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (44.51563pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Specifically, the argument " dims" is changed from type " int" to type " int64_t" (defined Overfull \hbox (7.7746pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 in header file stdint.h). The function name is changed by inser ting the digit " 8" Overfull \hbox (53.24619pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 before the trailing data type code. Thus, astAddPixelMask$\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 becomes a stAddPixelMask8$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/c mtt/m/n/10 . Underfull \hbox (badness 10000) in paragraph at lines 12193--12193 [210] LaTeX Warning: Hyper reference `Moc' on page 211 undefined on input line 12282. LaTeX Warning: Hyper reference `Region' on page 211 undefined on input line 122 82. LaTeX Warning: Hyper reference `SkyFrame' on page 211 undefined on input line 1 2282. LaTeX Warning: Hyper reference `CmpFrame' on page 211 undefined on input line 1 2282. LaTeX Warning: Hyper reference `MinOrder' on page 211 undefined on input line 1 2282. LaTeX Warning: Hyper reference `MaxOrder' on page 211 undefined on input line 1 2282. Overfull \hbox (21.36719pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 Indicates how the Moc and Region are to be combined. Any of the following values Overfull \hbox (5.10265pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (1.42854pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the Region. Overfull \hbox (10.35136pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc LaTeX Warning: Hyper reference `Negated' on page 211 undefined on input line 12 282. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 When combining the Region with the Moc, it is assumed that the Moc has not been Overfull \hbox (17.69308pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 inverted (i.e. the current value of the Moc' s ' Negated' attri bute is ignored). LaTeX Warning: Hyper reference `astGetRegionDisc' on page 211 undefined on inpu t line 12282. Overfull \hbox (68.34322pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (21.36719pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 set it to a value that depends on the class of Region being add ed. If the Region Overfull \hbox (21.10475pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 being added is another Moc, the MaxOrder attribute of the Moc i s used. For other Overfull \hbox (10.60732pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 classes of Region, the value used corresponds to the resolution closest to 0.1% Overfull \hbox (54.43411pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 of the linear size of the Region being added (determined using method astGetRegionDisc). [211] LaTeX Warning: Hyper reference `Mapping' on page 212 undefined on input line 12 342. LaTeX Warning: Hyper reference `Frame' on page 212 undefined on input line 1234 2. LaTeX Warning: Hyper reference `FrameSet' on page 212 undefined on input line 1 2342. LaTeX Warning: Hyper reference `Variant' on page 212 undefined on input line 12 342. Overfull \hbox (16.11847pt too wide) in paragraph at lines 12342--12342 \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 12342--12342 \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 12342--12342 \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 12342--12342 \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 12342--12342 [][]\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 12342--12342 [][]\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 212 undefined on inp ut line 12342. Overfull \hbox (5.62103pt too wide) in paragraph at lines 12342--12342 [][]\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 12342--12342 \T1/cmtt/m/n/10 in another Frame. This is only the case if the astMirrorVariant s function has [212] LaTeX Warning: Hyper reference `Frame' on page 213 undefined on input line 1240 9. LaTeX Warning: Hyper reference `SkyFrame' on page 213 undefined on input line 1 2409. Overfull \hbox (18.48322pt too wide) in paragraph at lines 12409--12409 []\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 213 undefined on input line 1240 9. Overfull \hbox (42.09962pt too wide) in paragraph at lines 12409--12409 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12409--12409 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12409--12409 [] \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 12409--12409 \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 12409--12409 \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 12409--12409 \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 12409--12409 \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 12409--12409 [][]\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 12409--12409 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if this function is invoked with the [213] LaTeX Warning: Hyper reference `Object' on page 214 undefined on input line 124 66. LaTeX Warning: Hyper reference `RefCount' on page 214 undefined on input line 1 2466. LaTeX Warning: Hyper reference `astLock' on page 214 undefined on input line 12 466. Overfull \hbox (31.60219pt too wide) in paragraph at lines 12466--12466 [][]\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 12466--12466 [][]\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 12466--12466 \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 12466--12466 \T1/cmtt/m/n/10 circumstances. In particular, it will fail if the pointer suppl ed is not valid, [214] LaTeX Warning: Hyper reference `Frame' on page 215 undefined on input line 1253 3. LaTeX Warning: Hyper reference `Naxes' on page 215 undefined on input line 1253 3. Overfull \hbox (42.09962pt too wide) in paragraph at lines 12533--12533 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12533--12533 [] \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 215 undefined on input lin e 12533. Overfull \hbox (21.36719pt too wide) in paragraph at lines 12533--12533 [][]\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 12533--12533 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [215] LaTeX Warning: Hyper reference `Frame' on page 216 undefined on input line 1259 3. LaTeX Warning: Hyper reference `SkyFrame' on page 216 undefined on input line 1 2593. Overfull \hbox (0.10988pt too wide) in paragraph at lines 12593--12593 \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 12593--12593 [][]\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 12593--12593 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [216] LaTeX Warning: Hyper reference `Frame' on page 217 undefined on input line 1266 7. LaTeX Warning: Hyper reference `SkyFrame' on page 217 undefined on input line 1 2667. Overfull \hbox (39.63802pt too wide) in paragraph at lines 12667--12667 []\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 12667--12667 \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 217 undefined on input line 12 667. Overfull \hbox (68.60565pt too wide) in paragraph at lines 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \T1/cmtt/m/n/10 is made so that that the resulting list has the smallest range. Latitude values are [217] LaTeX Warning: Hyper reference `Frame' on page 218 undefined on input line 1272 7. LaTeX Warning: Hyper reference `SkyFrame' on page 218 undefined on input line 1 2727. Overfull \hbox (0.10988pt too wide) in paragraph at lines 12727--12727 \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 12727--12727 [][]\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 12727--12727 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [218] LaTeX Warning: Hyper reference `astEBuf' on page 219 undefined on input line 12 760. LaTeX Warning: Hyper reference `Plot' on page 219 undefined on input line 12760 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 12760--12760 [][]\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 12760--12760 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function to this function [219] LaTeX Warning: Hyper reference `Object' on page 220 undefined on input line 127 99. LaTeX Warning: Hyper reference `astEnd' on page 220 undefined on input line 127 99. LaTeX Warning: Hyper reference `astAnnul' on page 220 undefined on input line 1 2799. LaTeX Warning: Hyper reference `astExport' on page 220 undefined on input line 12799. LaTeX Warning: Hyper reference `astExempt' on page 220 undefined on input line 12799. LaTeX Warning: Hyper reference `RefCount' on page 220 undefined on input line 1 2799. [220] LaTeX Warning: Hyper reference `Plot' on page 221 undefined on input line 12863 . LaTeX Warning: Hyper reference `Plot3D' on page 221 undefined on input line 128 63. LaTeX Warning: Hyper reference `Frame' on page 221 undefined on input line 1286 3. Overfull \hbox (34.01819pt too wide) in paragraph at lines 12863--12863 \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 12863--12863 \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 12863--12863 [][]\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 12863--12863 [][]\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 221 undefined on input lin e 12863. Overfull \hbox (10.86975pt too wide) in paragraph at lines 12863--12863 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames [221] LaTeX Warning: Hyper reference `Plot' on page 222 undefined on input line 12908 . LaTeX Warning: Hyper reference `Frame' on page 222 undefined on input line 1290 8. Overfull \hbox (15.85603pt too wide) in paragraph at lines 12908--12908 \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 12908--12908 \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 12908--12908 \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 12908--12908 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e Frame of the [222] LaTeX Warning: Hyper reference `Box' on page 223 undefined on input line 13046. LaTeX Warning: Hyper reference `Region' on page 223 undefined on input line 130 46. LaTeX Warning: Hyper reference `Frame' on page 223 undefined on input line 1304 6. LaTeX Warning: Hyper reference `Interval' on page 223 undefined on input line 1 3046. LaTeX Warning: Hyper reference `SkyFrame' on page 223 undefined on input line 1 3046. LaTeX Warning: Hyper reference `Polygon' on page 223 undefined on input line 13 046. Overfull \hbox (31.55376pt too wide) in paragraph at lines 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 223 undefined on input line 1304 6. Overfull \hbox (10.60732pt too wide) in paragraph at lines 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \T1/cmtt/m/n/10 the shifted uncertainty Region then represents the uncertainty in the boundary LaTeX Warning: Hyper reference `Circle' on page 223 undefined on input line 130 46. LaTeX Warning: Hyper reference `Ellipse' on page 223 undefined on input line 13 046. LaTeX Warning: Hyper reference `Prism' on page 223 undefined on input line 1304 6. LaTeX Warning: Hyper reference `Object' on page 223 undefined on input line 130 46. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 223 undefined on input line 13046. LaTeX Warning: Hyper reference `astSimplify' on page 223 undefined on input lin e 13046. Overfull \hbox (5.3586pt too wide) in paragraph at lines 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [223] LaTeX Warning: Hyper reference `astSet' on page 224 undefined on input line 130 46. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 [] \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 13046--13046 \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 13046--13046 \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 13046--13046 [][]\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 13046--13046 []\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 13046--13046 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [224] LaTeX Warning: Hyper reference `Channel' on page 225 undefined on input line 13 145. LaTeX Warning: Hyper reference `Object' on page 225 undefined on input line 131 45. LaTeX Warning: Hyper reference `astWrite' on page 225 undefined on input line 1 3145. LaTeX Warning: Hyper reference `astRead' on page 225 undefined on input line 13 145. LaTeX Warning: Hyper reference `SinkFile' on page 225 undefined on input line 1 3145. LaTeX Warning: Hyper reference `SourceFile' on page 225 undefined on input line 13145. Overfull \hbox (8.56807pt too wide) in paragraph at lines 13145--13145 []\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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 []\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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 []\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 225 undefined on input line 131 45. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 [] \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 13145--13145 \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 13145--13145 \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 225 undefined on inp ut line 13145. LaTeX Warning: Hyper reference `astChannelData' on page 225 undefined on input line 13145. Overfull \hbox (26.6159pt too wide) in paragraph at lines 13145--13145 [][]\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 13145--13145 \T1/cmtt/m/n/10 and sink functions using the astPutChannelData function. The so urce or sink function [225] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13145--13145 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [226] LaTeX Warning: Hyper reference `Channel' on page 227 undefined on input line 13 187. LaTeX Warning: Hyper reference `astPutChannelData' on page 227 undefined on inp ut line 13187. Overfull \hbox (28.2446pt too wide) in paragraph at lines 13187--13187 \T1/cmtt/m/n/10 The pointer previously stored with the Channel using astPutChan nelData. A NULL pointer [227] LaTeX Warning: Hyper reference `ChebyMap' on page 228 undefined on input line 1 3253. Overfull \hbox (36.8509pt too wide) in paragraph at lines 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 228 undefined on input line 13253. Overfull \hbox (26.6159pt too wide) in paragraph at lines 13253--13253 [][]\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 13253--13253 \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 13253--13253 \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 13253--13253 [][]\T1/cmtt/m/n/10 If the above procedure fails to determine a bounding box, t he supplied arrays [228] LaTeX Warning: Hyper reference `ChebyMap' on page 229 undefined on input line 1 3466. LaTeX Warning: Hyper reference `Mapping' on page 229 undefined on input line 13 466. LaTeX Warning: Hyper reference `astPolyTran' on page 229 undefined on input lin e 13466. LaTeX Warning: Hyper reference `PolyMap' on page 229 undefined on input line 13 466. Overfull \hbox (23.4695pt too wide) in paragraph at lines 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). [229] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 230 undefined on input line 134 66. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13466--13466 \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 13466--13466 \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 13466--13466 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format [230] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13466--13466 [] \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 13466--13466 \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 13466--13466 \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 231 undefined on input line 134 66. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13466--13466 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [231] LaTeX Warning: Hyper reference `Circle' on page 232 undefined on input line 135 89. LaTeX Warning: Hyper reference `Region' on page 232 undefined on input line 135 89. LaTeX Warning: Hyper reference `Frame' on page 232 undefined on input line 1358 9. Overfull \hbox (13.18324pt too wide) in paragraph at lines 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 232 undefined on input line 1358 9. Overfull \hbox (42.09962pt too wide) in paragraph at lines 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 232 undefined on input line 13589. LaTeX Warning: Hyper reference `Ellipse' on page 232 undefined on input line 13 589. LaTeX Warning: Hyper reference `Prism' on page 232 undefined on input line 1358 9. LaTeX Warning: Hyper reference `Object' on page 232 undefined on input line 135 89. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 232 undefined on input line 13589. LaTeX Warning: Hyper reference `astSimplify' on page 232 undefined on input lin e 13589. Overfull \hbox (5.3586pt too wide) in paragraph at lines 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 232 undefined on input line 135 89. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13589--13589 \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 13589--13589 \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 13589--13589 \T1/cmtt/m/n/10 used is identical to that for the astSet function and may inclu de " printf" format [232] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13589--13589 [] \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 13589--13589 \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 13589--13589 \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 13589--13589 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [233] LaTeX Warning: Hyper reference `Circle' on page 234 undefined on input line 136 47. LaTeX Warning: Hyper reference `Region' on page 234 undefined on input line 136 47. Overfull \hbox (21.36719pt too wide) in paragraph at lines 13647--13647 \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 13647--13647 \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 13647--13647 \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 13647--13647 [] \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 13647--13647 \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 13647--13647 \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 13647--13647 [][]\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 13647--13647 \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 13647--13647 \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 13647--13647 \T1/cmtt/m/n/10 from original to new coordinate system is non-linear, the shape represented by [234] LaTeX Warning: Hyper reference `Object' on page 235 undefined on input line 137 00. LaTeX Warning: Hyper reference `astTest' on page 235 undefined on input line 13 700. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13700--13700 \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 13700--13700 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to clear the val ue of a read-only attribute. [235] Overfull \hbox (42.36206pt too wide) in paragraph at lines 13723--13723 [][]\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 13723--13723 \T1/cmtt/m/n/10 will not execute and will simply return without action. Using a stClearStatus [236] LaTeX Warning: Hyper reference `Plot' on page 237 undefined on input line 13835 . LaTeX Warning: Hyper reference `Clip' on page 237 undefined on input line 13835 . Overfull \hbox (6.6736pt too wide) in paragraph at lines 13835--13835 []\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 237 undefined on input line 1383 5. LaTeX Warning: Hyper reference `Nframe' on page 237 undefined on input line 138 35. Overfull \hbox (10.60732pt too wide) in paragraph at lines 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 []\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \T1/cmtt/m/n/10 any previously-established clipping Frame before setting up new clipping limits. LaTeX Warning: Hyper reference `astPlot' on page 237 undefined on input line 13 835. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 237 undefined on input line 138 35. Overfull \hbox (16.11847pt too wide) in paragraph at lines 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \T1/cmtt/m/n/10 plotted), you should supply all the bounds in reversed order, a nd set the ClipOp [237] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13835--13835 [][]\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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 238 undefined on input line 13 835. LaTeX Warning: Hyper reference `astTran2' on page 238 undefined on input line 1 3835. Overfull \hbox (15.85603pt too wide) in paragraph at lines 13835--13835 [][]\T1/cmtt/m/n/10 When a Plot is used as a Mapping to transform points (e.g. using astTran2), any [238] LaTeX Warning: Hyper reference `Object' on page 239 undefined on input line 138 83. LaTeX Warning: Hyper reference `RefCount' on page 239 undefined on input line 1 3883. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13883--13883 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [239] LaTeX Warning: Hyper reference `CmpFrame' on page 240 undefined on input line 1 3971. LaTeX Warning: Hyper reference `Frame' on page 240 undefined on input line 1397 1. LaTeX Warning: Hyper reference `Mapping' on page 240 undefined on input line 13 971. LaTeX Warning: Hyper reference `UnitMap' on page 240 undefined on input line 13 971. LaTeX Warning: Hyper reference `Region' on page 240 undefined on input line 139 71. Overfull \hbox (0.48381pt too wide) in paragraph at lines 13971--13971 []\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 240 undefined on input line 139 71. Overfull \hbox (10.86975pt too wide) in paragraph at lines 13971--13971 \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 13971--13971 \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 13971--13971 \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 13971--13971 [] \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 13971--13971 \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 13971--13971 \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 240 undefined on input line 139 71. Overfull \hbox (5.62103pt too wide) in paragraph at lines 13971--13971 [][]\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 13971--13971 []\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 13971--13971 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [240] LaTeX Warning: Hyper reference `CmpMap' on page 241 undefined on input line 140 90. LaTeX Warning: Hyper reference `Mapping' on page 241 undefined on input line 14 090. Overfull \hbox (42.47356pt too wide) in paragraph at lines 14090--14090 []\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 14090--14090 \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 14090--14090 \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 241 undefined on input line 140 90. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 [] \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 14090--14090 \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 14090--14090 \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 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 241 undefined on input line 14090 . LaTeX Warning: Hyper reference `Nin' on page 241 undefined on input line 14090. Overfull \hbox (26.6159pt too wide) in paragraph at lines 14090--14090 [][]\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 14090--14090 \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 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \T1/cmtt/m/n/10 requested, each Mapping will still be applied to the same coord inates, but in [241] Overfull \hbox (5.62103pt too wide) in paragraph at lines 14090--14090 [][]\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 242 undefined on input line 14 090. Overfull \hbox (5.3586pt too wide) in paragraph at lines 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 242 undefined on input line 140 90. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14090--14090 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [242] LaTeX Warning: Hyper reference `CmpRegion' on page 243 undefined on input line 14204. LaTeX Warning: Hyper reference `Region' on page 243 undefined on input line 142 04. LaTeX Warning: Hyper reference `Frame' on page 243 undefined on input line 1420 4. LaTeX Warning: Hyper reference `astConvert' on page 243 undefined on input line 14204. LaTeX Warning: Hyper reference `Mapping' on page 243 undefined on input line 14 204. LaTeX Warning: Hyper reference `SkyFrame' on page 243 undefined on input line 1 4204. Overfull \hbox (8.1457pt too wide) in paragraph at lines 14204--14204 []\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 14204--14204 \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 14204--14204 \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 14204--14204 \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 243 undefined on input line 142 04. Overfull \hbox (10.86975pt too wide) in paragraph at lines 14204--14204 \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 14204--14204 \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 14204--14204 \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 14204--14204 [] \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 14204--14204 \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 14204--14204 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [243] Overfull \hbox (5.3586pt too wide) in paragraph at lines 14204--14204 [][]\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 14204--14204 \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 14204--14204 \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 14204--14204 [][]\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 14204--14204 \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 244 undefined on input line 142 04. Overfull \hbox (5.62103pt too wide) in paragraph at lines 14204--14204 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [244] LaTeX Warning: Hyper reference `Table' on page 245 undefined on input line 1426 5. LaTeX Warning: Hyper reference `Ncolumn' on page 245 undefined on input line 14 265. Overfull \hbox (21.10475pt too wide) in paragraph at lines 14265--14265 \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 14265--14265 [][]\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 14265--14265 \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 14265--14265 \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 14265--14265 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [245] LaTeX Warning: Hyper reference `FitsTable' on page 246 undefined on input line 14383. Overfull \hbox (8.19696pt too wide) in paragraph at lines 14383--14383 []\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 14383--14383 \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 14383--14383 [] \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \T1/cmtt/m/n/10 the column contains any empty cells. Otherwise, a value of zero is returned. A value [246] Overfull \hbox (5.62103pt too wide) in paragraph at lines 14383--14383 [][]\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 14383--14383 \T1/cmtt/m/n/10 associated null value. This routine will return without action if the column [247] LaTeX Warning: Hyper reference `Table' on page 248 undefined on input line 1444 8. LaTeX Warning: Hyper reference `astAddColumn' on page 248 undefined on input li ne 14448. Overfull \hbox (2.89699pt too wide) in paragraph at lines 14448--14448 []\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 14448--14448 \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 14448--14448 \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 14448--14448 \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 14448--14448 [][]\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 14448--14448 \T1/cmtt/m/n/10 A value of zero is returned for " ndim" and the supplied values in " dims" are [248] LaTeX Warning: Hyper reference `FitsTable' on page 249 undefined on input line 14494. LaTeX Warning: Hyper reference `astGetColumnData' on page 249 undefined on inpu t line 14494. Overfull \hbox (22.67937pt too wide) in paragraph at lines 14494--14494 \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 14494--14494 Overfull \hbox (1.94693pt too wide) in paragraph at lines 14494--14494 [][]\T1/cmtt/m/n/10 An error will be reported if the named column does not exis t in the FitsTable. [249] LaTeX Warning: Hyper reference `FrameSet' on page 250 undefined on input line 1 4791. LaTeX Warning: Hyper reference `Mapping' on page 250 undefined on input line 14 791. LaTeX Warning: Hyper reference `Frame' on page 250 undefined on input line 1479 1. LaTeX Warning: Hyper reference `Domain' on page 250 undefined on input line 147 91. Overfull \hbox (0.37231pt too wide) in paragraph at lines 14791--14791 \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 250 undefined on input line 14 791. LaTeX Warning: Hyper reference `Base' on page 250 undefined on input line 14791 . Overfull \hbox (25.56616pt too wide) in paragraph at lines 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [] \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \T1/cmtt/m/n/10 are described by Frames (rather than FrameSets), since there is then usually only [250] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 251 undefined on input li ne 14791. LaTeX Warning: Hyper reference `AlignSideBand' on page 251 undefined on input l ine 14791. LaTeX Warning: Hyper reference `AlignSystem' on page 251 undefined on input lin e 14791. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 251 undefined on input line 14791. LaTeX Warning: Hyper reference `SideBand' on page 251 undefined on input line 1 4791. Overfull \hbox (2.52588pt too wide) in paragraph at lines 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 251 undefined on input line 147 91. Overfull \hbox (21.36719pt too wide) in paragraph at lines 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 251 undefined on input lin e 14791. LaTeX Warning: Hyper reference `TranInverse' on page 251 undefined on input lin e 14791. Overfull \hbox (39.7377pt too wide) in paragraph at lines 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \T1/cmtt/m/n/10 attention on it by specifying its domain in the " domainlist" s tring, or (b) making [251] LaTeX Warning: Hyper reference `SpecFrame' on page 252 undefined on input line 14791. Overfull \hbox (12.76088pt too wide) in paragraph at lines 14791--14791 \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 252 undefined on input line 14791. LaTeX Warning: Hyper reference `AlignTimeScale' on page 252 undefined on input line 14791. Overfull \hbox (23.25832pt too wide) in paragraph at lines 14791--14791 \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 252 undefined on input line 147 91. Overfull \hbox (2.26344pt too wide) in paragraph at lines 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 252 undefined on input line 1 4791. Overfull \hbox (13.02332pt too wide) in paragraph at lines 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \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 14791--14791 \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 14791--14791 \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 252 undefined on input lin e 14791. LaTeX Warning: Hyper reference `Equinox' on page 252 undefined on input line 14 791. Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \T1/cmtt/m/n/10 Creates a FrameSet which describes precession in the default FK5 celestial Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 \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 14791--14791 \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 252 undefined on input line 147 91. Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 []\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 14791--14791 \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 14791--14791 \T1/cmtt/m/n/10 way to obtain printed output (formatted in sexagesimal notation ) to show the LaTeX Warning: Hyper reference `SkyFrame' on page 252 undefined on input line 1 4791. Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 []\T1/cmtt/m/n/10 The returned pointer " cvt" indicates whether conversion was possible and will Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 \T1/cmtt/m/n/10 have the value AST__NULL if it was not. If conversion was possi ble, " cvt" will [252] Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 253 undefined on input line 14791. Overfull \hbox (21.36719pt too wide) in paragraph at lines 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [253] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. LaTeX Warning: Hyper reference `Polygon' on page 254 undefined on input line 14 993. LaTeX Warning: Hyper reference `Frame' on page 254 undefined on input line 1499 3. LaTeX Warning: Hyper reference `Domain' on page 254 undefined on input line 149 93. LaTeX Warning: Hyper reference `Title' on page 254 undefined on input line 1499 3. Overfull \hbox (5.33546pt too wide) in paragraph at lines 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \T1/cmtt/m/n/10 coordinate values at its centre or upper corner, as selected by parameter " starpix" [254] Overfull \hbox (15.85603pt too wide) in paragraph at lines 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 [][]\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 14993--14993 []\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 14993--14993 \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 14993--14993 \T1/cmtt/m/n/10 For example, astConvexD would be used to process " double" data , while astConvexS would Overfull \hbox (28.76947pt too wide) in paragraph at lines 14993--14993 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (13.02332pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" and " ubnd" are changed fro m type " int" to type Overfull \hbox (34.01819pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 " int64_t" (defined in header file stdint.h). The function name is changed by inserting Overfull \hbox (68.99234pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 the digit " 8" before the trailing data type code. Thus, astCon vex$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 becomes astConvex8$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T 1/cmtt/m/n/10 . Underfull \hbox (badness 10000) in paragraph at lines 14993--14993 [255] LaTeX Warning: Hyper reference `Object' on page 256 undefined on input line 150 41. Overfull \hbox (5.62103pt too wide) in paragraph at lines 15041--15041 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [256] LaTeX Warning: Hyper reference `Object' on page 257 undefined on input line 151 09. LaTeX Warning: Hyper reference `astGetFrame' on page 257 undefined on input lin e 15109. LaTeX Warning: Hyper reference `Frame' on page 257 undefined on input line 1510 9. LaTeX Warning: Hyper reference `FrameSet' on page 257 undefined on input line 1 5109. LaTeX Warning: Hyper reference `astClone' on page 257 undefined on input line 1 5109. Overfull \hbox (24.5254pt too wide) in paragraph at lines 15109--15109 []\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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 [][]\T1/cmtt/m/n/10 NULL pointers and a line number of zero are returned if an error has already occurred [257] LaTeX Warning: Hyper reference `TimeFrame' on page 258 undefined on input line 15165. LaTeX Warning: Hyper reference `System' on page 258 undefined on input line 151 65. LaTeX Warning: Hyper reference `TimeOrigin' on page 258 undefined on input line 15165. LaTeX Warning: Hyper reference `LTOffset' on page 258 undefined on input line 1 5165. LaTeX Warning: Hyper reference `TimeScale' on page 258 undefined on input line 15165. Overfull \hbox (26.35347pt too wide) in paragraph at lines 15165--15165 [][]\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 15165--15165 [][]\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 15165--15165 \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 15165--15165 \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 15165--15165 [][]\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 15165--15165 \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 15165--15165 [][]\T1/cmtt/m/n/10 Any inaccuracy in the system clock will be reflected in the value returned by [258] LaTeX Warning: Hyper reference `Plot' on page 259 undefined on input line 15238 . LaTeX Warning: Hyper reference `astDistance' on page 259 undefined on input lin e 15238. LaTeX Warning: Hyper reference `Frame' on page 259 undefined on input line 1523 8. LaTeX Warning: Hyper reference `Mapping' on page 259 undefined on input line 15 238. LaTeX Warning: Hyper reference `astClip' on page 259 undefined on input line 15 238. LaTeX Warning: Hyper reference `astPolyCurve' on page 259 undefined on input li ne 15238. LaTeX Warning: Hyper reference `astGenCurve' on page 259 undefined on input lin e 15238. LaTeX Warning: Hyper reference `astGridLine' on page 259 undefined on input lin e 15238. Overfull \hbox (42.09962pt too wide) in paragraph at lines 15238--15238 \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 15238--15238 \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 15238--15238 [][]\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 259 undefined on input lin e 15238. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15238--15238 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [259] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 260 undefined on input li ne 15312. LaTeX Warning: Hyper reference `SpecFrame' on page 260 undefined on input line 15312. LaTeX Warning: Hyper reference `SideBand' on page 260 undefined on input line 1 5312. LaTeX Warning: Hyper reference `IF' on page 260 undefined on input line 15312. LaTeX Warning: Hyper reference `astSet' on page 260 undefined on input line 153 12. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15312--15312 \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 15312--15312 \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 15312--15312 \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 15312--15312 [] \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 15312--15312 \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 15312--15312 \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 260 undefined on input line 153 12. Overfull \hbox (5.62103pt too wide) in paragraph at lines 15312--15312 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [260] LaTeX Warning: Hyper reference `Mapping' on page 261 undefined on input line 15 438. LaTeX Warning: Hyper reference `Frame' on page 261 undefined on input line 1543 8. Overfull \hbox (27.14977pt too wide) in paragraph at lines 15438--15438 []\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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 261 undefined on input line 154 38. LaTeX Warning: Hyper reference `CmpMap' on page 261 undefined on input line 154 38. Overfull \hbox (39.2669pt too wide) in paragraph at lines 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 261 undefined on input line 15 438. Overfull \hbox (44.51563pt too wide) in paragraph at lines 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \T1/cmtt/m/n/10 will be returned holding the current value of the Invert attrib ute for the supplied [261] LaTeX Warning: Hyper reference `CmpFrame' on page 262 undefined on input line 1 5438. Overfull \hbox (2.52588pt too wide) in paragraph at lines 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 [][]\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 15438--15438 \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 15438--15438 [][]\T1/cmtt/m/n/10 Any changes made to the component Mappings using the return ed pointers will be [262] LaTeX Warning: Hyper reference `FitsChan' on page 263 undefined on input line 1 5477. LaTeX Warning: Hyper reference `Card' on page 263 undefined on input line 15477 . LaTeX Warning: Hyper reference `astFindFits' on page 263 undefined on input lin e 15477. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15477--15477 [][]\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 15477--15477 \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 15477--15477 [][]\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 15477--15477 \T1/cmtt/m/n/10 pointing at the " end-of-file" after deletion (i.e. is set to o ne more than the [263] LaTeX Warning: Hyper reference `Object' on page 264 undefined on input line 155 28. LaTeX Warning: Hyper reference `astBegin' on page 264 undefined on input line 1 5528. LaTeX Warning: Hyper reference `astEnd' on page 264 undefined on input line 155 28. LaTeX Warning: Hyper reference `astClone' on page 264 undefined on input line 1 5528. LaTeX Warning: Hyper reference `astAnnul' on page 264 undefined on input line 1 5528. Overfull \hbox (8.24539pt too wide) in paragraph at lines 15528--15528 [][]\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 15528--15528 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these [264] LaTeX Warning: Hyper reference `Frame' on page 265 undefined on input line 1558 8. Overfull \hbox (1.68732pt too wide) in paragraph at lines 15588--15588 []\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 265 undefined on input line 1558 8. Overfull \hbox (42.09962pt too wide) in paragraph at lines 15588--15588 \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 15588--15588 \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 15588--15588 [][]\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 15588--15588 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [265] LaTeX Warning: Hyper reference `Polygon' on page 266 undefined on input line 15 647. Overfull \hbox (42.09962pt too wide) in paragraph at lines 15647--15647 \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 15647--15647 \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 15647--15647 \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 15647--15647 \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 15647--15647 \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 266 undefined on input line 156 47. Overfull \hbox (5.62103pt too wide) in paragraph at lines 15647--15647 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [266] LaTeX Warning: Hyper reference `astBBuf' on page 267 undefined on input line 15 679. LaTeX Warning: Hyper reference `Plot' on page 267 undefined on input line 15679 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 15679--15679 [][]\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 15679--15679 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function simply invokes [267] LaTeX Warning: Hyper reference `Ellipse' on page 268 undefined on input line 15 819. LaTeX Warning: Hyper reference `Region' on page 268 undefined on input line 158 19. LaTeX Warning: Hyper reference `Frame' on page 268 undefined on input line 1581 9. Overfull \hbox (28.9294pt too wide) in paragraph at lines 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 268 undefined on input line 15819. LaTeX Warning: Hyper reference `Circle' on page 268 undefined on input line 158 19. LaTeX Warning: Hyper reference `Prism' on page 268 undefined on input line 1581 9. LaTeX Warning: Hyper reference `Object' on page 268 undefined on input line 158 19. Overfull \hbox (5.62103pt too wide) in paragraph at lines 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [268] LaTeX Warning: Hyper reference `astOverlap' on page 269 undefined on input line 15819. LaTeX Warning: Hyper reference `astSimplify' on page 269 undefined on input lin e 15819. Overfull \hbox (5.3586pt too wide) in paragraph at lines 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 269 undefined on input line 158 19. Overfull \hbox (10.86975pt too wide) in paragraph at lines 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 [] \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 15819--15819 \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 15819--15819 \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 15819--15819 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [269] Overfull \hbox (18.64314pt too wide) in paragraph at lines 15899--15899 []\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 270 undefined on input line 158 99. LaTeX Warning: Hyper reference `Ellipse' on page 270 undefined on input line 15 899. Overfull \hbox (0.37231pt too wide) in paragraph at lines 15899--15899 \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 15899--15899 \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 15899--15899 \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 15899--15899 \T1/cmtt/m/n/10 sense as rotation from the positive direction of Y to the posit ive direction of Overfull \hbox (10.60732pt too wide) in paragraph at lines 15899--15899 [] \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 15899--15899 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (15.85603pt too wide) in paragraph at lines 15899--15899 [] \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 15899--15899 \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 15899--15899 [][]\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 15899--15899 \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 15899--15899 \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 15899--15899 \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 15899--15899 [][]\T1/cmtt/m/n/10 Values of AST__BAD are returned for the parameters without error if the ellipse [270] LaTeX Warning: Hyper reference `FitsChan' on page 271 undefined on input line 1 5935. LaTeX Warning: Hyper reference `astWriteFits' on page 271 undefined on input li ne 15935. Overfull \hbox (39.7377pt too wide) in paragraph at lines 15935--15935 [][]\T1/cmtt/m/n/10 This method simply deletes the cards currently in the FitsC han. Unlike astWriteFits, [271] LaTeX Warning: Hyper reference `astBegin' on page 272 undefined on input line 1 5973. LaTeX Warning: Hyper reference `Object' on page 272 undefined on input line 159 73. LaTeX Warning: Hyper reference `astAnnul' on page 272 undefined on input line 1 5973. LaTeX Warning: Hyper reference `astExport' on page 272 undefined on input line 15973. LaTeX Warning: Hyper reference `astExempt' on page 272 undefined on input line 15973. LaTeX Warning: Hyper reference `RefCount' on page 272 undefined on input line 1 5973. [272] LaTeX Warning: Hyper reference `Plot' on page 273 undefined on input line 16037 . LaTeX Warning: Hyper reference `Escape' on page 273 undefined on input line 160 37. LaTeX Warning: Hyper reference `Title' on page 273 undefined on input line 1603 7. LaTeX Warning: Hyper reference `Frame' on page 273 undefined on input line 1603 7. Overfull \hbox (27.92809pt too wide) in paragraph at lines 16037--16037 \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 16037--16037 \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 16037--16037 \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 16037--16037 \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 273 undefined on input line 160 37. LaTeX Warning: Hyper reference `astStripEscapes' on page 273 undefined on input line 16037. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16037--16037 [][]\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 16037--16037 \T1/cmtt/m/n/10 sequences from the supplied string, or returns the supplied str ing without change. [273] LaTeX Warning: Hyper reference `Object' on page 274 undefined on input line 160 73. LaTeX Warning: Hyper reference `astBegin' on page 274 undefined on input line 1 6073. LaTeX Warning: Hyper reference `astEnd' on page 274 undefined on input line 160 73. LaTeX Warning: Hyper reference `astAnnul' on page 274 undefined on input line 1 6073. [274] LaTeX Warning: Hyper reference `Object' on page 275 undefined on input line 161 13. LaTeX Warning: Hyper reference `astEnd' on page 275 undefined on input line 161 13. LaTeX Warning: Hyper reference `astExempt' on page 275 undefined on input line 16113. Overfull \hbox (0.37231pt too wide) in paragraph at lines 16113--16113 [][]\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 16113--16113 \T1/cmtt/m/n/10 within (or exported to) the current context and have not been r endered exempt [275] LaTeX Warning: Hyper reference `FitsChan' on page 276 undefined on input line 1 6305. LaTeX Warning: Hyper reference `Card' on page 276 undefined on input line 16305 . Overfull \hbox (31.86462pt too wide) in paragraph at lines 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \T1/cmtt/m/n/10 Sets the Card attribute of a FitsChan to identify the next C OMMENT card (if [276] Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 277 undefined on input line 1 6305. Overfull \hbox (33.43924pt too wide) in paragraph at lines 16305--16305 [][]\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 16305--16305 \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 16305--16305 \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 16305--16305 [][]\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 16305--16305 [][]\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 16305--16305 []\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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 []\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 16305--16305 \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 16305--16305 [][]\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 16305--16305 \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 16305--16305 \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 16305--16305 [][]\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 16305--16305 [][]\T1/cmtt/m/n/10 The template " crpix%1d" will match keywords consisting of " CRPIX" followed by [277] Overfull \hbox (0.10988pt too wide) in paragraph at lines 16305--16305 [][]\T1/cmtt/m/n/10 The template " P%c" will match any keyword starting with " P" and followed by [278] LaTeX Warning: Hyper reference `Frame' on page 279 undefined on input line 1670 0. LaTeX Warning: Hyper reference `FrameSet' on page 279 undefined on input line 1 6700. LaTeX Warning: Hyper reference `Current' on page 279 undefined on input line 16 700. LaTeX Warning: Hyper reference `Mapping' on page 279 undefined on input line 16 700. Overfull \hbox (29.35176pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 will, in some sense, represent the " closest" non-virtual coord inate system to [279] LaTeX Warning: Hyper reference `SkyFrame' on page 280 undefined on input line 1 6700. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 280 undefined on input line 167 00. Overfull \hbox (0.10988pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 280 undefined on input lin e 16700. LaTeX Warning: Hyper reference `TranInverse' on page 280 undefined on input lin e 16700. Overfull \hbox (26.6159pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 280 undefined on input line 167 00. Overfull \hbox (34.01819pt too wide) in paragraph at lines 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 it represents. Otherwise, a null Object pointer (AST__NULL) is returned without error. [280] Overfull \hbox (27.71973pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 281 undefined on input line 1 6700. Overfull \hbox (13.02332pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 281 undefined on input line 1 6700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 281 undefined on input lin e 16700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 281 undefined on input line 16 700. LaTeX Warning: Hyper reference `CmpFrame' on page 281 undefined on input line 1 6700. LaTeX Warning: Hyper reference `PermMap' on page 281 undefined on input line 16 700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 281 undefined on input line 167 00. LaTeX Warning: Hyper reference `Equinox' on page 281 undefined on input line 16 700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 domain " PIXEL" . If this also fails, then any 2-dimensional co ordinate system [281] Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 282 undefined on input li ne 16700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 []\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 16700--16700 \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 282 undefined on input line 16 700. LaTeX Warning: Hyper reference `astPermAxes' on page 282 undefined on input lin e 16700. Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 282 undefined on input lin e 16700. Overfull \hbox (26.6159pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 [][]\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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 A successful match by the template depends on a number of crite ria, as outlined below: [282] Overfull \hbox (5.62103pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 283 undefined on input line 16 700. Overfull \hbox (29.24026pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 283 undefined on input line 1 6700. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 behaviour). You should consult the descriptions of these attrib utes for details [283] LaTeX Warning: Hyper reference `FitsChan' on page 284 undefined on input line 1 6876. LaTeX Warning: Hyper reference `Channel' on page 284 undefined on input line 16 876. LaTeX Warning: Hyper reference `System' on page 284 undefined on input line 168 76. LaTeX Warning: Hyper reference `Object' on page 284 undefined on input line 168 76. LaTeX Warning: Hyper reference `astWrite' on page 284 undefined on input line 1 6876. LaTeX Warning: Hyper reference `Card' on page 284 undefined on input line 16876 . LaTeX Warning: Hyper reference `astFindFits' on page 284 undefined on input lin e 16876. LaTeX Warning: Hyper reference `astPutFits' on page 284 undefined on input line 16876. LaTeX Warning: Hyper reference `astPutCards' on page 284 undefined on input lin e 16876. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 284 undefined on inp ut line 16876. LaTeX Warning: Hyper reference `astDelFits' on page 284 undefined on input line 16876. LaTeX Warning: Hyper reference `SourceFile' on page 284 undefined on input line 16876. LaTeX Warning: Hyper reference `SinkFile' on page 284 undefined on input line 1 6876. LaTeX Warning: Hyper reference `astRead' on page 284 undefined on input line 16 876. LaTeX Warning: Hyper reference `Encoding' on page 284 undefined on input line 1 6876. LaTeX Warning: Hyper reference `astRetainFits' on page 284 undefined on input l ine 16876. [284] Overfull \hbox (8.09445pt too wide) in paragraph at lines 16876--16876 []\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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 285 undefined on input line 168 76. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 [] \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 16876--16876 [][]\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 16876--16876 [][]\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 16876--16876 []\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 16876--16876 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [285] LaTeX Warning: Hyper reference `FitsTable' on page 286 undefined on input line 16955. LaTeX Warning: Hyper reference `Table' on page 286 undefined on input line 1695 5. LaTeX Warning: Hyper reference `FitsChan' on page 286 undefined on input line 1 6955. Overfull \hbox (17.69308pt too wide) in paragraph at lines 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 \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 286 undefined on input line 169 55. Overfull \hbox (10.86975pt too wide) in paragraph at lines 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 [] \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 16955--16955 \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 16955--16955 \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 286 undefined on input line 169 55. Overfull \hbox (5.62103pt too wide) in paragraph at lines 16955--16955 [][]\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 16955--16955 []\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 16955--16955 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [286] LaTeX Warning: Hyper reference `FluxFrame' on page 287 undefined on input line 17053. LaTeX Warning: Hyper reference `Frame' on page 287 undefined on input line 1705 3. LaTeX Warning: Hyper reference `System' on page 287 undefined on input line 170 53. LaTeX Warning: Hyper reference `SpecVal' on page 287 undefined on input line 17 053. Overfull \hbox (26.51622pt too wide) in paragraph at lines 17053--17053 []\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 287 undefined on input line 17053. LaTeX Warning: Hyper reference `Mapping' on page 287 undefined on input line 17 053. Overfull \hbox (31.60219pt too wide) in paragraph at lines 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 287 undefined on input line 17053. Overfull \hbox (10.60732pt too wide) in paragraph at lines 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 287 undefined on input line 170 53. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 [] \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 17053--17053 \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 17053--17053 \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 287 undefined on input lin e 17053. Overfull \hbox (21.36719pt too wide) in paragraph at lines 17053--17053 [][]\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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \T1/cmtt/m/n/10 positions measured in the two systems. In addition, any differe nce in the Unit [287] LaTeX Warning: Hyper reference `Object' on page 288 undefined on input line 170 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17053--17053 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [288] LaTeX Warning: Hyper reference `Frame' on page 289 undefined on input line 1711 6. Overfull \hbox (36.8509pt too wide) in paragraph at lines 17116--17116 \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 17116--17116 [][]\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 17116--17116 \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 17116--17116 \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 289 undefined on input lin e 17116. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17116--17116 [][]\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 17116--17116 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [289] LaTeX Warning: Hyper reference `Frame' on page 290 undefined on input line 1720 5. LaTeX Warning: Hyper reference `Title' on page 290 undefined on input line 1720 5. Overfull \hbox (15.85603pt too wide) in paragraph at lines 17205--17205 \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 290 undefined on input line 172 05. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17205--17205 \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 17205--17205 \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 17205--17205 \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 17205--17205 \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 17205--17205 [] \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 17205--17205 \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 17205--17205 \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 290 undefined on input line 17205 . Underfull \hbox (badness 10000) in paragraph at lines 17205--17205 Underfull \hbox (badness 10000) in paragraph at lines 17205--17205 [] \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 17205--17205 \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 17205--17205 Underfull \hbox (badness 10000) in paragraph at lines 17205--17205 [] \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 290 undefined on input line 172 05. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17205--17205 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [290] [291] LaTeX Warning: Hyper reference `FrameSet' on page 292 undefined on input line 1 7319. LaTeX Warning: Hyper reference `Mapping' on page 292 undefined on input line 17 319. LaTeX Warning: Hyper reference `Frame' on page 292 undefined on input line 1731 9. LaTeX Warning: Hyper reference `Base' on page 292 undefined on input line 17319 . LaTeX Warning: Hyper reference `Current' on page 292 undefined on input line 17 319. LaTeX Warning: Hyper reference `Title' on page 292 undefined on input line 1731 9. LaTeX Warning: Hyper reference `astInvert' on page 292 undefined on input line 17319. LaTeX Warning: Hyper reference `Region' on page 292 undefined on input line 173 19. LaTeX Warning: Hyper reference `astAddFrame' on page 292 undefined on input lin e 17319. Overfull \hbox (37.11334pt too wide) in paragraph at lines 17319--17319 \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 17319--17319 \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 292 undefined on input line 173 19. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 [] \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 17319--17319 \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 17319--17319 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [292] LaTeX Warning: Hyper reference `astCopy' on page 293 undefined on input line 17 319. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17319--17319 [][]\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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 293 undefined on input line 173 19. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17319--17319 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [293] LaTeX Warning: Hyper reference `Object' on page 294 undefined on input line 173 48. LaTeX Warning: Hyper reference `astToString' on page 294 undefined on input lin e 17348. Overfull \hbox (5.3586pt too wide) in paragraph at lines 17348--17348 \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 17348--17348 \T1/cmtt/m/n/10 Pointer to a new Object created from the supplied serialisation , or NULL if the serialisation [294] LaTeX Warning: Hyper reference `Mapping' on page 295 undefined on input line 17 402. LaTeX Warning: Hyper reference `astClip' on page 295 undefined on input line 17 402. LaTeX Warning: Hyper reference `astCurve' on page 295 undefined on input line 1 7402. LaTeX Warning: Hyper reference `astPolyCurve' on page 295 undefined on input li ne 17402. LaTeX Warning: Hyper reference `Plot' on page 295 undefined on input line 17402 . LaTeX Warning: Hyper reference `Frame' on page 295 undefined on input line 1740 2. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 295 undefined on input lin e 17402. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17402--17402 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [295] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. LaTeX Warning: Hyper reference `Object' on page 296 undefined on input line 174 84. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17484--17484 \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 17484--17484 \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 17484--17484 \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 296 undefined on input line 1 7484. Underfull \hbox (badness 10000) in paragraph at lines 17484--17484 LaTeX Warning: Hyper reference `Title' on page 296 undefined on input line 1748 4. Underfull \hbox (badness 10000) in paragraph at lines 17484--17484 Underfull \hbox (badness 10000) in paragraph at lines 17484--17484 [] \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 17484--17484 [][]\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 17484--17484 \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 17484--17484 [][]\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 17484--17484 \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 17484--17484 \T1/cmtt/m/n/10 of this function. After this, the memory containing the string may be re-used, [296] LaTeX Warning: Hyper reference `Frame' on page 297 undefined on input line 1752 2. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 297 undefined on inpu t line 17522. Overfull \hbox (31.86462pt too wide) in paragraph at lines 17522--17522 [][]\T1/cmtt/m/n/10 A zero value will be returned if this function is invoked w ith the AST error status [297] LaTeX Warning: Hyper reference `Moc' on page 298 undefined on input line 17565. LaTeX Warning: Hyper reference `MocLength' on page 298 undefined on input line 17565. Overfull \hbox (26.09103pt too wide) in paragraph at lines 17565--17565 \T1/cmtt/m/n/10 The index of the cell for which information is required. The fi rst cell has index Overfull \hbox (10.86975pt too wide) in paragraph at lines 17565--17565 \T1/cmtt/m/n/10 zero. An error will be reported if the supplied value is greate r than or equal [298] Overfull \hbox (2.6858pt too wide) in paragraph at lines 17661--17661 []\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 299 undefined on input line 17661. Overfull \hbox (22.67937pt too wide) in paragraph at lines 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 299 undefined on input l ine 17661. Overfull \hbox (15.85603pt too wide) in paragraph at lines 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 Overfull \hbox (0.10988pt too wide) in paragraph at lines 17661--17661 [][]\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 17661--17661 \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 17661--17661 \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 17661--17661 \T1/cmtt/m/n/10 astColumNull function. For columns holding string values, the A SCII NULL character [299] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. LaTeX Warning: Hyper reference `FitsChan' on page 300 undefined on input line 1 7821. Overfull \hbox (7.19565pt too wide) in paragraph at lines 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 \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 [300] Overfull \hbox (2.001pt too wide) in paragraph at lines 17821--17821 \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 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 [][]\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 17821--17821 [][]\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 301 undefined on input lin e 17821. Overfull \hbox (5.3586pt too wide) in paragraph at lines 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 \T1/cmtt/m/n/10 any trailing spaces) contains 8 or fewer characters. Trailing s paces are not [301] LaTeX Warning: Hyper reference `Frame' on page 302 undefined on input line 1787 3. LaTeX Warning: Hyper reference `FrameSet' on page 302 undefined on input line 1 7873. LaTeX Warning: Hyper reference `Nframe' on page 302 undefined on input line 178 73. Overfull \hbox (5.3586pt too wide) in paragraph at lines 17873--17873 \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 17873--17873 \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 17873--17873 [][]\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 302 undefined on input line 1 7873. LaTeX Warning: Hyper reference `Object' on page 302 undefined on input line 178 73. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17873--17873 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [302] LaTeX Warning: Hyper reference `KeyMap' on page 303 undefined on input line 179 06. LaTeX Warning: Hyper reference `astGrfSet' on page 303 undefined on input line 17906. LaTeX Warning: Hyper reference `Plot' on page 303 undefined on input line 17906 . Overfull \hbox (2.26344pt too wide) in paragraph at lines 17906--17906 \T1/cmtt/m/n/10 A pointer to the graphics context KeyMap. The returned pointer should be annulled [303] LaTeX Warning: Hyper reference `Mapping' on page 304 undefined on input line 17 981. LaTeX Warning: Hyper reference `FrameSet' on page 304 undefined on input line 1 7981. LaTeX Warning: Hyper reference `Frame' on page 304 undefined on input line 1798 1. Overfull \hbox (26.35347pt too wide) in paragraph at lines 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 [][]\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 17981--17981 \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 304 undefined on input line 179 81. LaTeX Warning: Hyper reference `UnitMap' on page 304 undefined on input line 17 981. Overfull \hbox (10.86975pt too wide) in paragraph at lines 17981--17981 [][]\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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 \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 304 undefined on input lin e 17981. LaTeX Warning: Hyper reference `TranInverse' on page 304 undefined on input lin e 17981. Overfull \hbox (0.37231pt too wide) in paragraph at lines 17981--17981 [][]\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 17981--17981 \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 17981--17981 \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 17981--17981 \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 304 undefined on input line 179 81. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17981--17981 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [304] LaTeX Warning: Hyper reference `Moc' on page 305 undefined on input line 18028. LaTeX Warning: Hyper reference `MocType' on page 305 undefined on input line 18 028. LaTeX Warning: Hyper reference `MocLength' on page 305 undefined on input line 18028. LaTeX Warning: Hyper reference `astGetMocHeader' on page 305 undefined on input line 18028. Overfull \hbox (0.10988pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 The length of the supplied array in bytes. An error will be rep orted if this Overfull \hbox (0.10988pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 value is smaller than the number required to describe the Moc ( the product of Overfull \hbox (38.68796pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 Pointer to the area of memory in which to return the signed int eger cell identifiers. [305] LaTeX Warning: Hyper reference `FitsChan' on page 306 undefined on input line 1 8050. LaTeX Warning: Hyper reference `Moc' on page 306 undefined on input line 18050. LaTeX Warning: Hyper reference `astGetMocData' on page 306 undefined on input l ine 18050. [306] LaTeX Warning: Hyper reference `Moc' on page 307 undefined on input line 18103. Overfull \hbox (31.76494pt too wide) in paragraph at lines 18103--18103 []\T1/cmtt/m/n/10 void astGetMocString( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int json, size_t mxsize, char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 string, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 size, Overfull \hbox (26.6159pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 If non-zero, the Moc is encoded using JSON serialisation. Other wise it is encoded Overfull \hbox (0.10988pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 The length of the supplied string buffer in bytes. An error wil l be reported Overfull \hbox (13.49411pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 if this value is smaller than the number required to describe t he Moc. However, Overfull \hbox (16.11847pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 if zero is supplied, the buffer will be ignored - no string wil l be returned but Overfull \hbox (68.60565pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 Pointer to the area of memory in which to return the JSON or st ring-encoded representation Overfull \hbox (21.36719pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 of the Moc. This area is assumed to contain at least ' mxsize' bytes. Only used Overfull \hbox (58.10822pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 Returned holding the number of bytes needed to store the comple te JSON or string-encoded [307] LaTeX Warning: Hyper reference `RefRA' on page 308 undefined on input line 1815 9. LaTeX Warning: Hyper reference `RefDec' on page 308 undefined on input line 181 59. LaTeX Warning: Hyper reference `SkyFrame' on page 308 undefined on input line 1 8159. Overfull \hbox (7.30714pt too wide) in paragraph at lines 18159--18159 []\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 308 undefined on input line 18159. Overfull \hbox (7.19565pt too wide) in paragraph at lines 18159--18159 \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 18159--18159 \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 18159--18159 \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.60732pt too wide) in paragraph at lines 18159--18159 [] \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 18159--18159 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error [308] LaTeX Warning: Hyper reference `Region' on page 309 undefined on input line 182 19. LaTeX Warning: Hyper reference `Frame' on page 309 undefined on input line 1821 9. LaTeX Warning: Hyper reference `Negated' on page 309 undefined on input line 18 219. Overfull \hbox (28.19052pt too wide) in paragraph at lines 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 [][]\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 18219--18219 [][]\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 18219--18219 \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 18219--18219 \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 18219--18219 [][]\T1/cmtt/m/n/10 If the bounds on an axis cannot be determined, AST__BAD is returned for both upper [309] LaTeX Warning: Hyper reference `Region' on page 310 undefined on input line 182 74. LaTeX Warning: Hyper reference `Frame' on page 310 undefined on input line 1827 4. LaTeX Warning: Hyper reference `Negated' on page 310 undefined on input line 18 274. Overfull \hbox (10.86975pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 Pointer to a two-element array in which to return the axis valu es at the centre Overfull \hbox (5.62103pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 Pointer to a variable in which to return the radius of the boun ding disc, as a Overfull \hbox (26.6159pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 geodesic distance within the Frame represented by the Region. I t will be returned Overfull \hbox (26.6159pt too wide) in paragraph at lines 18274--18274 [][]\T1/cmtt/m/n/10 The value of the Negated attribute is ignored (i.e. it is a ssumed that the Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 18274--18274 [][]\T1/cmtt/m/n/10 If the Region is unbounded, the radius will be returned set to AST__BAD and the [310] LaTeX Warning: Hyper reference `Frame' on page 311 undefined on input line 1831 2. LaTeX Warning: Hyper reference `Region' on page 311 undefined on input line 183 12. Overfull \hbox (12.49844pt too wide) in paragraph at lines 18312--18312 \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 18312--18312 \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 311 undefined on input line 183 12. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18312--18312 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [311] LaTeX Warning: Hyper reference `FrameSet' on page 312 undefined on input line 1 8353. LaTeX Warning: Hyper reference `Region' on page 312 undefined on input line 183 53. LaTeX Warning: Hyper reference `Frame' on page 312 undefined on input line 1835 3. LaTeX Warning: Hyper reference `astGetRegionFrame' on page 312 undefined on inp ut line 18353. Overfull \hbox (28.2446pt too wide) in paragraph at lines 18353--18353 \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 312 undefined on input line 183 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18353--18353 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [312] LaTeX Warning: Hyper reference `Region' on page 313 undefined on input line 184 40. LaTeX Warning: Hyper reference `MeshSize' on page 313 undefined on input line 1 8440. Overfull \hbox (12.97206pt too wide) in paragraph at lines 18440--18440 []\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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 313 undefined on input line 184 40. LaTeX Warning: Hyper reference `Box' on page 313 undefined on input line 18440. Overfull \hbox (16.11847pt too wide) in paragraph at lines 18440--18440 [][]\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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied LaTeX Warning: Hyper reference `SkyFrame' on page 313 undefined on input line 1 8440. Overfull \hbox (2.99667pt too wide) in paragraph at lines 18440--18440 [][]\T1/cmtt/m/n/10 If the Region defines an area within a SkyFrame that traver ses zero longitude, Overfull \hbox (42.36206pt too wide) in paragraph at lines 18440--18440 \T1/cmtt/m/n/10 the returned positions will be normalised to avoid jumps of 2.P I radians in longitude [313] LaTeX Warning: Hyper reference `Region' on page 314 undefined on input line 185 89. Overfull \hbox (32.0758pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 314 undefined on input line 18589. LaTeX Warning: Hyper reference `Circle' on page 314 undefined on input line 185 89. Overfull \hbox (2.26344pt too wide) in paragraph at lines 18589--18589 \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 314 undefined on input line 18589. LaTeX Warning: Hyper reference `astDecompose' on page 314 undefined on input li ne 18589. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 314 undefined on input line 18 589. Overfull \hbox (7.51216pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 314 undefined on input line 1 8589. Overfull \hbox (44.25319pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 18589--18589 \T1/cmtt/m/n/10 rather than an included interval. See the Interval constructor for more information. [314] LaTeX Warning: Hyper reference `NullRegion' on page 315 undefined on input line 18589. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18589--18589 \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 315 undefined on input line 18589. Overfull \hbox (24.83293pt too wide) in paragraph at lines 18589--18589 \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 315 undefined on input line 18 589. Overfull \hbox (7.51216pt too wide) in paragraph at lines 18589--18589 \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 315 undefined on input line 1858 9. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 18589--18589 [][]\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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [315] LaTeX Warning: Hyper reference `Stc' on page 316 undefined on input line 18644. LaTeX Warning: Hyper reference `KeyMap' on page 316 undefined on input line 186 44. LaTeX Warning: Hyper reference `System' on page 316 undefined on input line 186 44. Overfull \hbox (0.10988pt too wide) in paragraph at lines 18644--18644 \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 18644--18644 \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 18644--18644 LaTeX Warning: Hyper reference `Object' on page 316 undefined on input line 186 44. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18644--18644 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [316] LaTeX Warning: Hyper reference `Stc' on page 317 undefined on input line 18680. Overfull \hbox (13.49411pt too wide) in paragraph at lines 18680--18680 [][]\T1/cmtt/m/n/10 Zero will be returned if this function is invoked with the AST error status set, [317] LaTeX Warning: Hyper reference `Region' on page 318 undefined on input line 187 17. LaTeX Warning: Hyper reference `Stc' on page 318 undefined on input line 18717. LaTeX Warning: Hyper reference `Object' on page 318 undefined on input line 187 17. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18717--18717 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [318] LaTeX Warning: Hyper reference `FitsChan' on page 319 undefined on input line 1 8760. LaTeX Warning: Hyper reference `FitsTable' on page 319 undefined on input line 18760. LaTeX Warning: Hyper reference `astAnnul' on page 319 undefined on input line 1 8760. Overfull \hbox (28.19052pt too wide) in paragraph at lines 18760--18760 [][]\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 319 undefined on inp ut line 18760. Overfull \hbox (33.43924pt too wide) in paragraph at lines 18760--18760 [][]\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 18760--18760 \T1/cmtt/m/n/10 To modify the FitsTable, the modified FitsChan must be stored i n the FitsTable [319] LaTeX Warning: Hyper reference `FitsChan' on page 320 undefined on input line 1 8816. LaTeX Warning: Hyper reference `KeyMap' on page 320 undefined on input line 188 16. LaTeX Warning: Hyper reference `FitsTable' on page 320 undefined on input line 18816. LaTeX Warning: Hyper reference `astPutTable' on page 320 undefined on input lin e 18816. LaTeX Warning: Hyper reference `astPutTables' on page 320 undefined on input li ne 18816. LaTeX Warning: Hyper reference `astWrite' on page 320 undefined on input line 1 8816. LaTeX Warning: Hyper reference `FrameSet' on page 320 undefined on input line 1 8816. LaTeX Warning: Hyper reference `TabOK' on page 320 undefined on input line 1881 6. LaTeX Warning: Hyper reference `astAnnul' on page 320 undefined on input line 1 8816. Overfull \hbox (10.13652pt too wide) in paragraph at lines 18816--18816 \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 18816--18816 \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 320 undefined on input line 188 16. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18816--18816 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [320] LaTeX Warning: Hyper reference `Region' on page 321 undefined on input line 189 07. LaTeX Warning: Hyper reference `astSetUnc' on page 321 undefined on input line 18907. Overfull \hbox (47.34834pt too wide) in paragraph at lines 18907--18907 \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 18907--18907 \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 18907--18907 \T1/cmtt/m/n/10 Region used internally within AST is returned (see " Applicabil ity" below). If LaTeX Warning: Hyper reference `CmpRegion' on page 321 undefined on input line 18907. Overfull \hbox (24.83293pt too wide) in paragraph at lines 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 321 undefined on input line 1890 7. Overfull \hbox (18.0096pt too wide) in paragraph at lines 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 321 undefined on input line 189 07. LaTeX Warning: Hyper reference `astMapRegion' on page 321 undefined on input li ne 18907. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18907--18907 [][]\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 18907--18907 \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 18907--18907 \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 18907--18907 \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 321 undefined on input line 189 07. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18907--18907 [][]\T1/cmtt/m/n/10 A null Object pointer (NULL) will be returned if this funct ion is invoked with [321] LaTeX Warning: Hyper reference `astGrfPush' on page 322 undefined on input line 18944. LaTeX Warning: Hyper reference `Plot' on page 322 undefined on input line 18944 . LaTeX Warning: Hyper reference `astGrfSet' on page 322 undefined on input line 18944. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18944--18944 [][]\T1/cmtt/m/n/10 This function returns without action if there are no snapsh ots to restore. No [322] LaTeX Warning: Hyper reference `Plot' on page 323 undefined on input line 18975 . LaTeX Warning: Hyper reference `astGrfPop' on page 323 undefined on input line 18975. LaTeX Warning: Hyper reference `astGrfSet' on page 323 undefined on input line 18975. [323] LaTeX Warning: Hyper reference `Plot' on page 324 undefined on input line 19446 . LaTeX Warning: Hyper reference `ast_link' on page 324 undefined on input line 1 9446. LaTeX Warning: Hyper reference `Grf' on page 324 undefined on input line 19446. Overfull \hbox (31.60219pt too wide) in paragraph at lines 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 324 undefined on input line 19 446. Overfull \hbox (2.26344pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 324 undefined on input line 194 46. LaTeX Warning: Hyper reference `astGetGrfContext' on page 324 undefined on inpu t line 19446. Overfull \hbox (12.76088pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \T1/cmtt/m/n/10 the functions listed below should never annul or delete the sup plied KeyMap pointer. [324] Overfull \hbox (18.0096pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \T1/cmtt/m/n/10 return zero, in which case " M" justification will never be req uested by Plot. The [325] LaTeX Warning: Hyper reference `Escape' on page 326 undefined on input line 194 46. Overfull \hbox (2.52588pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 []\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 19446--19446 []\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 19446--19446 []\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 19446--19446 []\T1/cmtt/m/n/10 The " Mark" function displays markers at the given positions. It requires the following [326] Overfull \hbox (28.19052pt too wide) in paragraph at lines 19446--19446 [][]\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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements [327] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19446--19446 [][]\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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\T1/cmtt/m/n/10 yb - An array of 4 elements in which to return the y coordi nate of each corner [328] LaTeX Warning: Hyper reference `Plot' on page 329 undefined on input line 19491 . LaTeX Warning: Hyper reference `Plot3D' on page 329 undefined on input line 194 91. LaTeX Warning: Hyper reference `RootCorner' on page 329 undefined on input line 19491. Overfull \hbox (47.61078pt too wide) in paragraph at lines 19491--19491 [][]\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 19491--19491 \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 19491--19491 \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 19491--19491 \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 329 undefined on input line 1949 1. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19491--19491 [][]\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 329 undefined on input lin e 19491. LaTeX Warning: Hyper reference `TranInverse' on page 329 undefined on input lin e 19491. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19491--19491 [][]\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 19491--19491 \T1/cmtt/m/n/10 of the Plot is not defined in either direction (i.e. the Plot' s TranForward [329] LaTeX Warning: Hyper reference `Plot' on page 330 undefined on input line 19558 . LaTeX Warning: Hyper reference `astGrid' on page 330 undefined on input line 19 558. LaTeX Warning: Hyper reference `Mapping' on page 330 undefined on input line 19 558. LaTeX Warning: Hyper reference `astClip' on page 330 undefined on input line 19 558. LaTeX Warning: Hyper reference `Naxes' on page 330 undefined on input line 1955 8. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19558--19558 \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 19558--19558 \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 19558--19558 \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 19558--19558 \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 19558--19558 [][]\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 330 undefined on input line 1955 8. LaTeX Warning: Hyper reference `TranInverse' on page 330 undefined on input lin e 19558. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19558--19558 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [330] LaTeX Warning: Hyper reference `GrismMap' on page 331 undefined on input line 1 9625. LaTeX Warning: Hyper reference `Mapping' on page 331 undefined on input line 19 625. LaTeX Warning: Hyper reference `GrismWaveR' on page 331 undefined on input line 19625. LaTeX Warning: Hyper reference `GrismNRP' on page 331 undefined on input line 1 9625. LaTeX Warning: Hyper reference `GrismG' on page 331 undefined on input line 196 25. LaTeX Warning: Hyper reference `astSet' on page 331 undefined on input line 196 25. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19625--19625 \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 19625--19625 \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 19625--19625 \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 19625--19625 [] \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 19625--19625 \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 19625--19625 \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 331 undefined on input line 196 25. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19625--19625 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [331] LaTeX Warning: Hyper reference `Object' on page 332 undefined on input line 196 73. Overfull \hbox (10.60732pt too wide) in paragraph at lines 19673--19673 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [332] LaTeX Warning: Hyper reference `Table' on page 333 undefined on input line 1971 0. LaTeX Warning: Hyper reference `astAddColumn' on page 333 undefined on input li ne 19710. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19710--19710 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces [333] LaTeX Warning: Hyper reference `Table' on page 334 undefined on input line 1974 7. LaTeX Warning: Hyper reference `astAddParameter' on page 334 undefined on input line 19747. Overfull \hbox (31.60219pt too wide) in paragraph at lines 19747--19747 \T1/cmtt/m/n/10 The character string holding the upper case name of the paramet er. Trailing spaces [334] LaTeX Warning: Hyper reference `Object' on page 335 undefined on input line 197 77. LaTeX Warning: Hyper reference `astEnd' on page 335 undefined on input line 197 77. [335] LaTeX Warning: Hyper reference `Frame' on page 336 undefined on input line 1986 7. LaTeX Warning: Hyper reference `SkyFrame' on page 336 undefined on input line 1 9867. Overfull \hbox (28.71822pt too wide) in paragraph at lines 19867--19867 []\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 336 undefined on input line 1986 7. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \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 19867--19867 \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 19867--19867 [][]\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 19867--19867 \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 19867--19867 [][]\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 19867--19867 \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 336 undefined on input lin e 19867. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19867--19867 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between [336] LaTeX Warning: Hyper reference `Interval' on page 337 undefined on input line 2 0000. LaTeX Warning: Hyper reference `Region' on page 337 undefined on input line 200 00. LaTeX Warning: Hyper reference `Frame' on page 337 undefined on input line 2000 0. LaTeX Warning: Hyper reference `SkyFrame' on page 337 undefined on input line 2 0000. LaTeX Warning: Hyper reference `Box' on page 337 undefined on input line 20000. Overfull \hbox (10.55888pt too wide) in paragraph at lines 20000--20000 []\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 20000--20000 \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 20000--20000 \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 337 undefined on input line 2000 0. Overfull \hbox (42.09962pt too wide) in paragraph at lines 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 337 undefined on input line 200 00. LaTeX Warning: Hyper reference `Ellipse' on page 337 undefined on input line 20 000. LaTeX Warning: Hyper reference `Prism' on page 337 undefined on input line 2000 0. LaTeX Warning: Hyper reference `Object' on page 337 undefined on input line 200 00. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20000--20000 []\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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 337 undefined on input line 20000. LaTeX Warning: Hyper reference `astSimplify' on page 337 undefined on input lin e 20000. Overfull \hbox (5.3586pt too wide) in paragraph at lines 20000--20000 []\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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [337] LaTeX Warning: Hyper reference `astSet' on page 338 undefined on input line 200 00. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 [] \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 20000--20000 \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 20000--20000 \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 20000--20000 [][]\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 20000--20000 []\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 20000--20000 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [338] LaTeX Warning: Hyper reference `IntraMap' on page 339 undefined on input line 2 0092. LaTeX Warning: Hyper reference `Mapping' on page 339 undefined on input line 20 092. LaTeX Warning: Hyper reference `astIntraReg' on page 339 undefined on input lin e 20092. Overfull \hbox (5.52135pt too wide) in paragraph at lines 20092--20092 []\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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \T1/cmtt/m/n/10 output coordinates produced by the transformation function (as specified when LaTeX Warning: Hyper reference `astSet' on page 339 undefined on input line 200 92. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 [] \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 20092--20092 \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 20092--20092 \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 339 undefined on input line 200 92. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20092--20092 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [339] [340] LaTeX Warning: Hyper reference `IntraMap' on page 341 undefined on input line 2 0275. LaTeX Warning: Hyper reference `Mapping' on page 341 undefined on input line 20 275. LaTeX Warning: Hyper reference `astIntraMap' on page 341 undefined on input lin e 20275. LaTeX Warning: Hyper reference `Channel' on page 341 undefined on input line 20 275. Overfull \hbox (5.78378pt too wide) in paragraph at lines 20275--20275 []\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 341 undefined on input line 2 0275. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \T1/cmtt/m/n/10 external user who does not have access to the function, then th ese contact details [341] Overfull \hbox (10.86975pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 342 undefined on input li ne 20275. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 []\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 20275--20275 \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 20275--20275 \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 342 undefined on input lin e 20275. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 342 undefined on input lin e 20275. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 342 undefined on input line 20 275. LaTeX Warning: Hyper reference `astSimplify' on page 342 undefined on input lin e 20275. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 20275--20275 \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 20275--20275 \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 20275--20275 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using astSimplify). [342] [343] LaTeX Warning: Hyper reference `Mapping' on page 344 undefined on input line 20 300. LaTeX Warning: Hyper reference `Invert' on page 344 undefined on input line 203 00. [344] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. LaTeX Warning: Hyper reference `Object' on page 345 undefined on input line 203 63. LaTeX Warning: Hyper reference `Class' on page 345 undefined on input line 2036 3. Overfull \hbox (3.47949pt too wide) in paragraph at lines 20363--20363 \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 345 undefined on input line 2036 3. Underfull \hbox (badness 10000) in paragraph at lines 20363--20363 Underfull \hbox (badness 10000) in paragraph at lines 20363--20363 [] \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 20363--20363 [][]\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 20363--20363 [][]\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 20363--20363 \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 20363--20363 [][]\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 20363--20363 \T1/cmtt/m/n/10 particular, it will fail if the pointer supplied does not ident ify an Object of [345] LaTeX Warning: Hyper reference `KeyMap' on page 346 undefined on input line 204 38. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 346 undefined on inp ut line 20438. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 346 undefined on inp ut line 20438. LaTeX Warning: Hyper reference `KeyCase' on page 346 undefined on input line 20 438. LaTeX Warning: Hyper reference `Object' on page 346 undefined on input line 204 38. LaTeX Warning: Hyper reference `Mapping' on page 346 undefined on input line 20 438. LaTeX Warning: Hyper reference `astSet' on page 346 undefined on input line 204 38. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20438--20438 \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 20438--20438 \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 20438--20438 \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 20438--20438 [] \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 20438--20438 \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 20438--20438 \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 20438--20438 [][]\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 20438--20438 []\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 20438--20438 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [346] LaTeX Warning: Hyper reference `Mapping' on page 347 undefined on input line 20 556. Overfull \hbox (18.90558pt too wide) in paragraph at lines 20556--20556 []\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 347 undefined on input line 20556. Overfull \hbox (26.6159pt too wide) in paragraph at lines 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.10475pt too wide) in paragraph at lines 20556--20556 [] \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 347 undefined on input line 20556 . Overfull \hbox (21.10475pt too wide) in paragraph at lines 20556--20556 [] \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 347 undefined on input line 20556. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20556--20556 [][]\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 20556--20556 \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 20556--20556 [][]\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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \T1/cmtt/m/n/10 If all Mapping outputs generate bad values, then zero is return ed as the function [347] Overfull \hbox (26.35347pt too wide) in paragraph at lines 20556--20556 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (2.99667pt too wide) in paragraph at lines 20556--20556 [][]\T1/cmtt/m/n/10 If all tested positions within the supplied box generate ba d output positions, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20556--20556 \T1/cmtt/m/n/10 then the returned function value will be zero. However, the ret urned coefficients Overfull \hbox (31.60219pt too wide) in paragraph at lines 20556--20556 \T1/cmtt/m/n/10 will represent a unit transformation, except that the constant term for each output [348] LaTeX Warning: Hyper reference `Object' on page 349 undefined on input line 206 34. LaTeX Warning: Hyper reference `astUnlock' on page 349 undefined on input line 20634. Overfull \hbox (21.10475pt too wide) in paragraph at lines 20634--20634 \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 20634--20634 \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 20634--20634 \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 20634--20634 \T1/cmtt/m/n/10 is reported and the function returns immediately without lockin g the Object. LaTeX Warning: Hyper reference `astAnnul' on page 349 undefined on input line 2 0634. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20634--20634 [][]\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 20634--20634 \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 20634--20634 [][]\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 349 undefined on input line 20 634. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20634--20634 [][]\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 20634--20634 \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 20634--20634 \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 20634--20634 \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 20634--20634 [][]\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 20634--20634 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [349] LaTeX Warning: Hyper reference `LutMap' on page 350 undefined on input line 207 45. LaTeX Warning: Hyper reference `Mapping' on page 350 undefined on input line 20 745. Overfull \hbox (7.72334pt too wide) in paragraph at lines 20745--20745 []\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 (5.3586pt too wide) in paragraph at lines 20745--20745 \T1/cmtt/m/n/10 The input coordinate value which corresponds to the centre of t he first lookup Overfull \hbox (36.8509pt too wide) in paragraph at lines 20745--20745 \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 20745--20745 \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 350 undefined on input line 207 45. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20745--20745 \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 20745--20745 \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 20745--20745 \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 20745--20745 [] \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 20745--20745 \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 20745--20745 \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 350 undefined on input lin e 20745. Overfull \hbox (26.6159pt too wide) in paragraph at lines 20745--20745 [][]\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 20745--20745 \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 20745--20745 \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 20745--20745 \T1/cmtt/m/n/10 of zero, so that any attempt to use the inverse transformation will result in [350] LaTeX Warning: Hyper reference `Object' on page 351 undefined on input line 207 45. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20745--20745 [][]\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 20745--20745 []\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 20745--20745 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [351] LaTeX Warning: Hyper reference `Mapping' on page 352 undefined on input line 20 888. Overfull \hbox (18.22078pt too wide) in paragraph at lines 20888--20888 []\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 []\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 20888--20888 \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 20888--20888 \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 352 undefined on input line 20888 . Overfull \hbox (41.83719pt too wide) in paragraph at lines 20888--20888 []\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.35347pt too wide) in paragraph at lines 20888--20888 [] \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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [352] Overfull \hbox (26.35347pt too wide) in paragraph at lines 20888--20888 [] \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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 values on entry will not be altered if the function is invoked with the AST error [353] LaTeX Warning: Hyper reference `KeyMap' on page 354 undefined on input line 209 34. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20934--20934 [][]\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 20934--20934 [][]\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 20934--20934 \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 20934--20934 \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 20934--20934 \T1/cmtt/m/n/10 using this function, rather than simply replacing the destinati on KeyMap entry. LaTeX Warning: Hyper reference `MapLocked' on page 354 undefined on input line 20934. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20934--20934 [][]\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 20934--20934 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [354] LaTeX Warning: Hyper reference `KeyMap' on page 355 undefined on input line 209 98. Overfull \hbox (2.89699pt too wide) in paragraph at lines 20998--20998 []\T1/cmtt/m/n/10 void astMapCopyEntry( AstKeyMap $\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 key, AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 that, int merge LaTeX Warning: Hyper reference `KeyCase' on page 355 undefined on input line 20 998. Overfull \hbox (0.10988pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 The character string identifying the value to be copied. Traili ng spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase LaTeX Warning: Hyper reference `astMapCopy' on page 355 undefined on input line 20998. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 Indicates what to do if the named entry holds a KeyMap and a Ke yMap entry with Overfull \hbox (0.37231pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 the same key already exists in the destination KeyMap. If zero, the existing Overfull \hbox (7.19565pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 destination KeyMap will be deleted and replaced by a copy of th e source KeyMap. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 If non-zero, all entries in the source KeyMap will be copied in to the existing Overfull \hbox (31.86462pt too wide) in paragraph at lines 20998--20998 [][]\T1/cmtt/m/n/10 This fuction returns without action if the named entry does not exist in the source Overfull \hbox (31.86462pt too wide) in paragraph at lines 20998--20998 [][]\T1/cmtt/m/n/10 Entries from the source KeyMap will replace any existing en tries in the destination LaTeX Warning: Hyper reference `MapLocked' on page 355 undefined on input line 20998. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20998--20998 [][]\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 20998--20998 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [355] LaTeX Warning: Hyper reference `KeyMap' on page 356 undefined on input line 210 36. LaTeX Warning: Hyper reference `astMapHasKey' on page 356 undefined on input li ne 21036. LaTeX Warning: Hyper reference `KeyCase' on page 356 undefined on input line 21 036. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21036--21036 \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 21036--21036 \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 21036--21036 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name is prese nt in the KeyMap and [356] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. LaTeX Warning: Hyper reference `KeyMap' on page 357 undefined on input line 211 66. LaTeX Warning: Hyper reference `KeyCase' on page 357 undefined on input line 21 166. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21166--21166 \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 21166--21166 \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 357 undefined on input line 21166. Overfull \hbox (10.60732pt too wide) in paragraph at lines 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 [][]\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 21166--21166 \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 21166--21166 [][]\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 357 undefined on input line 21 166. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21166--21166 [][]\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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 357 undefined on input line 211 66. LaTeX Warning: Hyper reference `astAnnul' on page 357 undefined on input line 2 1166. Overfull \hbox (0.37231pt too wide) in paragraph at lines 21166--21166 [][]\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 21166--21166 \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 21166--21166 \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 21166--21166 \T1/cmtt/m/n/10 Object. The returned pointer should be annulled using astAnnul when it is no [357] Overfull \hbox (8.46577pt too wide) in paragraph at lines 21166--21166 []\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 21166--21166 \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 21166--21166 \T1/cmtt/m/n/10 For example, astMapGet0D would be used to get a " double" value , while astMapGet0I [358] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. LaTeX Warning: Hyper reference `KeyMap' on page 359 undefined on input line 213 14. Overfull \hbox (15.56409pt too wide) in paragraph at lines 21314--21314 []\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 21314--21314 \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 359 undefined on input line 21 314. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 21314--21314 \T1/cmtt/m/n/10 " value" array. Any unused elements of the array are left uncha nged. Zero is LaTeX Warning: Hyper reference `astMapPutU' on page 359 undefined on input line 21314. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 [][]\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 21314--21314 \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 21314--21314 [][]\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 21314--21314 []\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 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 when invoking astMapGet1C, and should include space for a termi nating null character. [359] Overfull \hbox (8.46577pt too wide) in paragraph at lines 21314--21314 []\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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 For A, the supplied " value" parameter should be a pointer to a n array of AstObject [360] LaTeX Warning: Hyper reference `KeyMap' on page 361 undefined on input line 213 84. LaTeX Warning: Hyper reference `KeyCase' on page 361 undefined on input line 21 384. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21384--21384 \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 21384--21384 \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 361 undefined on input line 21384. Overfull \hbox (36.8509pt too wide) in paragraph at lines 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 [][]\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 21384--21384 \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 361 undefined on input line 21 384. Overfull \hbox (10.86975pt too wide) in paragraph at lines 21384--21384 [][]\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 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer [361] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. LaTeX Warning: Hyper reference `KeyMap' on page 362 undefined on input line 215 18. Overfull \hbox (5.06665pt too wide) in paragraph at lines 21518--21518 []\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 21518--21518 \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 362 undefined on input line 21 518. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21518--21518 \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 21518--21518 \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 21518--21518 \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 362 undefined on input line 21518. Overfull \hbox (10.60732pt too wide) in paragraph at lines 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 [][]\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 21518--21518 \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 21518--21518 []\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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 []\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 21518--21518 \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 [362] Overfull \hbox (34.01819pt too wide) in paragraph at lines 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \T1/cmtt/m/n/10 be a pointer to a character string with " l" elements. For A, t he supplied " value" [363] LaTeX Warning: Hyper reference `KeyMap' on page 364 undefined on input line 215 70. LaTeX Warning: Hyper reference `KeyCase' on page 364 undefined on input line 21 570. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21570--21570 \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 21570--21570 \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 364 undefined on input l ine 21570. Overfull \hbox (26.6159pt too wide) in paragraph at lines 21570--21570 [][]\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 21570--21570 \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 21570--21570 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [364] LaTeX Warning: Hyper reference `KeyMap' on page 365 undefined on input line 216 30. LaTeX Warning: Hyper reference `astMapSize' on page 365 undefined on input line 21630. LaTeX Warning: Hyper reference `SortBy' on page 365 undefined on input line 216 30. Overfull \hbox (26.09103pt too wide) in paragraph at lines 21630--21630 \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 21630--21630 \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 21630--21630 [][]\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 21630--21630 \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 21630--21630 \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 21630--21630 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [365] LaTeX Warning: Hyper reference `KeyMap' on page 366 undefined on input line 216 82. LaTeX Warning: Hyper reference `KeyCase' on page 366 undefined on input line 21 682. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21682--21682 \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 21682--21682 \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 21682--21682 \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 21682--21682 [][]\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 21682--21682 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [366] LaTeX Warning: Hyper reference `KeyMap' on page 367 undefined on input line 217 27. LaTeX Warning: Hyper reference `KeyCase' on page 367 undefined on input line 21 727. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21727--21727 \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 21727--21727 \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 21727--21727 \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 21727--21727 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [367] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. LaTeX Warning: Hyper reference `KeyMap' on page 368 undefined on input line 218 40. Overfull \hbox (46.79396pt too wide) in paragraph at lines 21840--21840 []\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 368 undefined on input line 21 840. Overfull \hbox (31.33975pt too wide) in paragraph at lines 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 [][]\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 368 undefined on input line 218 40. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21840--21840 [][]\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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 []\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 21840--21840 \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 [368] Overfull \hbox (13.02332pt too wide) in paragraph at lines 21840--21840 \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 369 undefined on input line 21 840. LaTeX Warning: Hyper reference `astWrite' on page 369 undefined on input line 2 1840. Overfull \hbox (7.98578pt too wide) in paragraph at lines 21840--21840 []\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 [369] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. LaTeX Warning: Hyper reference `KeyMap' on page 370 undefined on input line 219 47. Overfull \hbox (33.46098pt too wide) in paragraph at lines 21947--21947 []\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 370 undefined on input line 21 947. Overfull \hbox (36.58847pt too wide) in paragraph at lines 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 [][]\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 21947--21947 []\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 21947--21947 \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 21947--21947 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I [370] LaTeX Warning: Hyper reference `astShow' on page 371 undefined on input line 21 947. LaTeX Warning: Hyper reference `astWrite' on page 371 undefined on input line 2 1947. Overfull \hbox (7.98578pt too wide) in paragraph at lines 21947--21947 []\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 [371] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. LaTeX Warning: Hyper reference `KeyMap' on page 372 undefined on input line 220 75. Overfull \hbox (4.59303pt too wide) in paragraph at lines 22075--22075 []\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 372 undefined on input line 22 075. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \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 372 undefined on input line 2207 5. LaTeX Warning: Hyper reference `astAddColumn' on page 372 undefined on input li ne 22075. Overfull \hbox (4.1005pt too wide) in paragraph at lines 22075--22075 \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 22075--22075 \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 22075--22075 [][]\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 22075--22075 [][]\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 22075--22075 \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 22075--22075 []\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 22075--22075 \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 [372] Overfull \hbox (34.01819pt too wide) in paragraph at lines 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \T1/cmtt/m/n/10 to a character string. For A, the supplied " value" parameter s hould be an AstObject [373] LaTeX Warning: Hyper reference `KeyMap' on page 374 undefined on input line 221 25. LaTeX Warning: Hyper reference `MapLocked' on page 374 undefined on input line 22125. LaTeX Warning: Hyper reference `KeyCase' on page 374 undefined on input line 22 125. Overfull \hbox (31.33975pt too wide) in paragraph at lines 22125--22125 \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 22125--22125 \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 22125--22125 \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 22125--22125 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the va lue associated with [374] LaTeX Warning: Hyper reference `Region' on page 375 undefined on input line 221 93. LaTeX Warning: Hyper reference `Mapping' on page 375 undefined on input line 22 193. LaTeX Warning: Hyper reference `PermMap' on page 375 undefined on input line 22 193. LaTeX Warning: Hyper reference `MathMap' on page 375 undefined on input line 22 193. LaTeX Warning: Hyper reference `SphMap' on page 375 undefined on input line 221 93. Overfull \hbox (47.61078pt too wide) in paragraph at lines 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 375 undefined on input line 2219 3. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22193--22193 \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 22193--22193 \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 22193--22193 [][]\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 375 undefined on input line 221 93. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22193--22193 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [375] LaTeX Warning: Hyper reference `KeyMap' on page 376 undefined on input line 222 22. LaTeX Warning: Hyper reference `KeyCase' on page 376 undefined on input line 22 222. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22222--22222 \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 22222--22222 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the KeyCase [376] LaTeX Warning: Hyper reference `KeyMap' on page 377 undefined on input line 222 59. LaTeX Warning: Hyper reference `KeyCase' on page 377 undefined on input line 22 259. Overfull \hbox (5.3586pt too wide) in paragraph at lines 22259--22259 \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 22259--22259 \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 22259--22259 \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 22259--22259 \T1/cmtt/m/n/10 are ignored. The supplied string is converted to upper case bef ore use if the [377] LaTeX Warning: Hyper reference `KeyMap' on page 378 undefined on input line 222 93. Overfull \hbox (5.3586pt too wide) in paragraph at lines 22293--22293 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [378] LaTeX Warning: Hyper reference `Mapping' on page 379 undefined on input line 22 376. Overfull \hbox (24.31422pt too wide) in paragraph at lines 22376--22376 []\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 379 undefined on input line 22376. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22376--22376 [] \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 [][]\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 22376--22376 \T1/cmtt/m/n/10 fail for any reason, then a NULL value will be returned for the " map" pointer. [379] LaTeX Warning: Hyper reference `KeyMap' on page 380 undefined on input line 224 37. LaTeX Warning: Hyper reference `KeyCase' on page 380 undefined on input line 22 437. Overfull \hbox (12.18193pt too wide) in paragraph at lines 22437--22437 \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 22437--22437 \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 22437--22437 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__KINTTYPE (for LaTeX Warning: Hyper reference `Object' on page 380 undefined on input line 224 37. LaTeX Warning: Hyper reference `astMapPutU' on page 380 undefined on input line 22437. Overfull \hbox (79.10309pt too wide) in paragraph at lines 22437--22437 [][]\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 22437--22437 \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 22437--22437 \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 22437--22437 \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 22437--22437 [][]\T1/cmtt/m/n/10 A function value of AST__BADTYPE will be returned if an err or has already occurred, [380] LaTeX Warning: Hyper reference `Plot' on page 381 undefined on input line 22523 . Overfull \hbox (13.18324pt too wide) in paragraph at lines 22523--22523 []\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 22523--22523 \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 381 undefined on input line 2252 3. LaTeX Warning: Hyper reference `Naxes' on page 381 undefined on input line 2252 3. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.09962pt too wide) in paragraph at lines 22523--22523 [] \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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 [][]\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 22523--22523 \T1/cmtt/m/n/10 AST__BAD (or where the transformation into graphical coordinate s yields coordinates LaTeX Warning: Hyper reference `astClip' on page 381 undefined on input line 22 523. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22523--22523 [][]\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 381 undefined on input lin e 22523. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22523--22523 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [381] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. LaTeX Warning: Hyper reference `Region' on page 382 undefined on input line 227 40. Overfull \hbox (3.90186pt too wide) in paragraph at lines 22740--22740 []\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 382 undefined on input line 22 740. LaTeX Warning: Hyper reference `UnitMap' on page 382 undefined on input line 22 740. Overfull \hbox (0.37231pt too wide) in paragraph at lines 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \T1/cmtt/m/n/10 system of the supplied Region corresponds to pixel coordinates. This is equivalent LaTeX Warning: Hyper reference `Nin' on page 382 undefined on input line 22740. LaTeX Warning: Hyper reference `Naxes' on page 382 undefined on input line 2274 0. LaTeX Warning: Hyper reference `Nout' on page 382 undefined on input line 22740 . Overfull \hbox (26.35347pt too wide) in paragraph at lines 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 382 undefined on input line 22 740. Overfull \hbox (26.35347pt too wide) in paragraph at lines 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 382 undefined on input line 22740. Overfull \hbox (16.11847pt too wide) in paragraph at lines 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates [382] Overfull \hbox (0.37231pt too wide) in paragraph at lines 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 [] \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 22740--22740 \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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 [][]\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 22740--22740 [][]\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 22740--22740 []\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 22740--22740 \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 22740--22740 \T1/cmtt/m/n/10 For example, astMaskD would be used to process " double" data, while astMaskS would Overfull \hbox (28.76947pt too wide) in paragraph at lines 22740--22740 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (13.02332pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" and " ubnd" are changed fro m type " int" to type Overfull \hbox (12.76088pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 " int64_t" (defined in header file stdint.h). The function retu rn type is similarly Overfull \hbox (2.52588pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 changed to type int64_t. The function name is changed by insert ing the digit " 8" [383] [384] LaTeX Warning: Hyper reference `Frame' on page 385 undefined on input line 2280 2. LaTeX Warning: Hyper reference `Axis' on page 385 undefined on input line 22802 . Overfull \hbox (5.62103pt too wide) in paragraph at lines 22802--22802 \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 22802--22802 \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 22802--22802 \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 22802--22802 []\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 385 undefined on input line 22 802. LaTeX Warning: Hyper reference `astFindFrame' on page 385 undefined on input li ne 22802. LaTeX Warning: Hyper reference `astConvert' on page 385 undefined on input line 22802. LaTeX Warning: Hyper reference `SkyFrame' on page 385 undefined on input line 2 2802. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22802--22802 [][]\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 22802--22802 \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 22802--22802 \T1/cmtt/m/n/10 identical. For instance, SkyFrame axes in two Frames will match even if they [385] LaTeX Warning: Hyper reference `MathMap' on page 386 undefined on input line 23 539. LaTeX Warning: Hyper reference `Mapping' on page 386 undefined on input line 23 539. LaTeX Warning: Hyper reference `IntraMap' on page 386 undefined on input line 2 3539. Overfull \hbox (28.9294pt too wide) in paragraph at lines 23539--23539 []\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 386 undefined on input line 23539. Overfull \hbox (16.11847pt too wide) in paragraph at lines 23539--23539 \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 386 undefined on input line 23539 . Overfull \hbox (0.37231pt too wide) in paragraph at lines 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 contain the expressions defining the inverse transformation. Th e syntax of these LaTeX Warning: Hyper reference `astSet' on page 386 undefined on input line 235 39. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [] \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [386] LaTeX Warning: Hyper reference `Seed' on page 387 undefined on input line 23539 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 \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 387 undefined on input lin e 23539. LaTeX Warning: Hyper reference `SimpFI' on page 387 undefined on input line 235 39. LaTeX Warning: Hyper reference `SimpIF' on page 387 undefined on input line 235 39. Overfull \hbox (16.11847pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 387 undefined on input line 235 39. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 undefined, you must supply dummy expressions which simply name each of the output (or [387] Overfull \hbox (2.52588pt too wide) in paragraph at lines 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 performed by MathMap transformations. The special value AST__BA D can be represented [388] Overfull \hbox (29.46065pt too wide) in paragraph at lines 23539--23539 []\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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 []\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 [][]\T1/cmtt/m/n/10 x1 != x2: Tests whether " x1" is unequal to " x2" . (The sy nonym " .ne." is [389] Overfull \hbox (8.7222pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 point are also inverted. To invert only those bits to the left of the binary point, [390] Overfull \hbox (22.9418pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\T1/cmtt/m/n/10 sign(x1, x2): Absolute value of " x1" with the sign of " x2 " (transfer of sign). [391] Overfull \hbox (3.21706pt too wide) in paragraph at lines 23539--23539 []\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 23539--23539 [][]$\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 23539--23539 \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 23539--23539 [][]$\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 392 undefined on input line 23539 . Overfull \hbox (26.37558pt too wide) in paragraph at lines 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 \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 23539--23539 \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 23539--23539 []\T1/cmtt/m/n/10 Items appearing in expressions are evaluated in the following order (highest precedence [392] Overfull \hbox (26.35948pt too wide) in paragraph at lines 23539--23539 \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 [393] LaTeX Warning: Hyper reference `MatrixMap' on page 394 undefined on input line 23660. LaTeX Warning: Hyper reference `Mapping' on page 394 undefined on input line 23 660. Overfull \hbox (18.22078pt too wide) in paragraph at lines 23660--23660 []\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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 \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 394 undefined on input line 236 60. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 [] \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 23660--23660 \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 23660--23660 \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 394 undefined on input lin e 23660. LaTeX Warning: Hyper reference `TranInverse' on page 394 undefined on input lin e 23660. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23660--23660 [][]\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 23660--23660 \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 23660--23660 \T1/cmtt/m/n/10 attribute) will only be available if the associated matrix is s quare and non-singular. [394] Overfull \hbox (21.36719pt too wide) in paragraph at lines 23660--23660 [][]\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 23660--23660 \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 23660--23660 \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 23660--23660 \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 395 undefined on input line 236 60. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23660--23660 [][]\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 23660--23660 []\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 23660--23660 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [395] LaTeX Warning: Hyper reference `Variant' on page 396 undefined on input line 23 733. LaTeX Warning: Hyper reference `Frame' on page 396 undefined on input line 2373 3. LaTeX Warning: Hyper reference `FrameSet' on page 396 undefined on input line 2 3733. LaTeX Warning: Hyper reference `Mapping' on page 396 undefined on input line 23 733. LaTeX Warning: Hyper reference `Nframe' on page 396 undefined on input line 237 33. Overfull \hbox (21.10475pt too wide) in paragraph at lines 23733--23733 \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 23733--23733 \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 23733--23733 \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 23733--23733 \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 23733--23733 [][]\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 23733--23733 \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 396 undefined on input l ine 23733. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23733--23733 [][]\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 23733--23733 \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 23733--23733 [][]\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 23733--23733 [][]\T1/cmtt/m/n/10 Any variant Mappings explicitly added to the current Frame using astAddVariant [396] LaTeX Warning: Hyper reference `Moc' on page 397 undefined on input line 23832. LaTeX Warning: Hyper reference `Region' on page 397 undefined on input line 238 32. LaTeX Warning: Hyper reference `Adaptive' on page 397 undefined on input line 2 3832. LaTeX Warning: Hyper reference `astGetMocData' on page 397 undefined on input l ine 23832. LaTeX Warning: Hyper reference `astGetMocHeader' on page 397 undefined on input line 23832. LaTeX Warning: Hyper reference `astAddMocData' on page 397 undefined on input l ine 23832. Underfull \hbox (badness 10000) in paragraph at lines 23832--23832 LaTeX Warning: Hyper reference `astSet' on page 397 undefined on input line 238 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23832--23832 \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 23832--23832 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Mo c. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23832--23832 \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 23832--23832 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (26.6159pt too wide) in paragraph at lines 23832--23832 \T1/cmtt/m/n/10 of additional parameters may follow it in order to supply value s to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23832--23832 \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 397 undefined on input line 238 32. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23832--23832 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [397] Overfull \hbox (2.26344pt too wide) in paragraph at lines 23832--23832 []\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 23832--23832 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [398] LaTeX Warning: Hyper reference `MocChan' on page 399 undefined on input line 23 939. LaTeX Warning: Hyper reference `Channel' on page 399 undefined on input line 23 939. LaTeX Warning: Hyper reference `Moc' on page 399 undefined on input line 23939. LaTeX Warning: Hyper reference `astWrite' on page 399 undefined on input line 2 3939. LaTeX Warning: Hyper reference `SinkFile' on page 399 undefined on input line 2 3939. LaTeX Warning: Hyper reference `SourceFile' on page 399 undefined on input line 23939. Overfull \hbox (8.56807pt too wide) in paragraph at lines 23939--23939 []\T1/cmtt/m/n/10 AstMocChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMocChan( 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 23939--23939 \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 this function will be used by the MocChan to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 []\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 23939--23939 \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 this function will be used by the MocChan to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 []\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 399 undefined on input line 239 39. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Mo cChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 [] \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [399] Overfull \hbox (8.24539pt too wide) in paragraph at lines 23939--23939 [][]\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 23939--23939 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character LaTeX Warning: Hyper reference `Object' on page 400 undefined on input line 239 39. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23939--23939 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [400] LaTeX Warning: Hyper reference `Region' on page 401 undefined on input line 239 62. LaTeX Warning: Hyper reference `Negated' on page 401 undefined on input line 23 962. [401] LaTeX Warning: Hyper reference `Frame' on page 402 undefined on input line 2401 9. LaTeX Warning: Hyper reference `Naxes' on page 402 undefined on input line 2401 9. Overfull \hbox (49.9727pt too wide) in paragraph at lines 24019--24019 \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 24019--24019 \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 24019--24019 \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 24019--24019 \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 24019--24019 [][]\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 24019--24019 \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 24019--24019 \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 402 undefined on input line 24 019. LaTeX Warning: Hyper reference `Mapping' on page 402 undefined on input line 24 019. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24019--24019 [][]\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 402 undefined on input line 24019. Overfull \hbox (16.11847pt too wide) in paragraph at lines 24019--24019 [][]\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 24019--24019 \T1/cmtt/m/n/10 for display by using this function to normalise them, followed by appropriate [402] LaTeX Warning: Hyper reference `NormMap' on page 403 undefined on input line 24 099. LaTeX Warning: Hyper reference `Mapping' on page 403 undefined on input line 24 099. LaTeX Warning: Hyper reference `astNorm' on page 403 undefined on input line 24 099. LaTeX Warning: Hyper reference `Frame' on page 403 undefined on input line 2409 9. LaTeX Warning: Hyper reference `astSimplify' on page 403 undefined on input lin e 24099. LaTeX Warning: Hyper reference `UnitMap' on page 403 undefined on input line 24 099. LaTeX Warning: Hyper reference `CmpMap' on page 403 undefined on input line 240 99. Overfull \hbox (17.43065pt too wide) in paragraph at lines 24099--24099 \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 403 undefined on input line 240 99. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24099--24099 \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 24099--24099 \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 24099--24099 \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 24099--24099 [] \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 24099--24099 \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 24099--24099 \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 403 undefined on input line 240 99. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24099--24099 [][]\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 24099--24099 []\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 24099--24099 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [403] LaTeX Warning: Hyper reference `Frame' on page 404 undefined on input line 2422 5. LaTeX Warning: Hyper reference `astNorm' on page 404 undefined on input line 24 225. Overfull \hbox (23.4695pt too wide) in paragraph at lines 24225--24225 []\T1/cmtt/m/n/10 void astNormPoints( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int npoint, int ncoord_in, int indim, const double Overfull \hbox (5.3586pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point. This should be Overfull \hbox (36.8509pt too wide) in paragraph at lines 24225--24225 \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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (57.84578pt too wide) in paragraph at lines 24225--24225 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord_in][indim]" Overfull \hbox (5.62103pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 , containing the coordinates of the input (unnormalised) points . These should Overfull \hbox (26.35347pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be stored such that the value of coordinate number " coord" for input point number LaTeX Warning: Hyper reference `SkyFrame' on page 404 undefined on input line 2 4225. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 Indicates the way in which the normalised axis values are to be calculated. A Overfull \hbox (16.11847pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 non-zero value causes the values to be normalised in such a way as to reduce the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 effects of any discontinuities in the coordinate system. For in stance, points Overfull \hbox (16.11847pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 in a SkyFrame that span longitude zero will be normalized into a longitude range Overfull \hbox (13.70848pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 of -pi to $\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 pi (otherwise the y will be normalized into a range of 0 to 2.pi). A Overfull \hbox (10.60732pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 The number of coordinates being supplied for each output point. This should be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24225--24225 \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 24225--24225 \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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (7.19565pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 , into which the coordinates of the output (normalised) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [404] Overfull \hbox (42.36206pt too wide) in paragraph at lines 24225--24225 [][]\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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 cyclic quantities (such as angles or positions on the sky), coo rdinates will typically Overfull \hbox (0.5835pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be wrapped into an appropriate standard range, such as zero to 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 pi or -pi to Overfull \hbox (44.51563pt too wide) in paragraph at lines 24225--24225 []\T1/cmtt/m/n/10 If the number of points to be normalised exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (13.02332pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 Specifically, the arguments " npoint" , " indim" and " outdim" are changed from type Overfull \hbox (2.52588pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 " int" to type " int64_t" (defined in header file stdint.h). Th e function name is Overfull \hbox (55.01306pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 changed by appending the digit " 8" to the name. Thus, astNormP oints becomes astNormPoints8 Underfull \hbox (badness 10000) in paragraph at lines 24225--24225 [405] LaTeX Warning: Hyper reference `NullRegion' on page 406 undefined on input line 24310. LaTeX Warning: Hyper reference `Region' on page 406 undefined on input line 243 10. LaTeX Warning: Hyper reference `Negated' on page 406 undefined on input line 24 310. Overfull \hbox (5.73253pt too wide) in paragraph at lines 24310--24310 []\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 406 undefined on input line 2431 0. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 406 undefined on input line 24310. LaTeX Warning: Hyper reference `Circle' on page 406 undefined on input line 243 10. LaTeX Warning: Hyper reference `Ellipse' on page 406 undefined on input line 24 310. LaTeX Warning: Hyper reference `Prism' on page 406 undefined on input line 2431 0. LaTeX Warning: Hyper reference `Object' on page 406 undefined on input line 243 10. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24310--24310 []\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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 406 undefined on input line 243 10. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 [] \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 24310--24310 \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 24310--24310 \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 24310--24310 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [406] LaTeX Warning: Hyper reference `astClearStatus' on page 407 undefined on input line 24343. Overfull \hbox (42.36206pt too wide) in paragraph at lines 24343--24343 [][]\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 24343--24343 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [407] LaTeX Warning: Hyper reference `Frame' on page 408 undefined on input line 2441 9. Overfull \hbox (12.97206pt too wide) in paragraph at lines 24419--24419 []\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 408 undefined on input line 2441 9. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 408 undefined on input lin e 24419. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24419--24419 [][]\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 24419--24419 [][]\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 24419--24419 [][]\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 24419--24419 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [408] LaTeX Warning: Hyper reference `Frame' on page 409 undefined on input line 2450 5. Overfull \hbox (26.3563pt too wide) in paragraph at lines 24505--24505 []\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 409 undefined on input line 2450 5. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 409 undefined on input lin e 24505. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24505--24505 [][]\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 24505--24505 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [409] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. LaTeX Warning: Hyper reference `Polygon' on page 410 undefined on input line 24 790. LaTeX Warning: Hyper reference `Frame' on page 410 undefined on input line 2479 0. LaTeX Warning: Hyper reference `Domain' on page 410 undefined on input line 247 90. LaTeX Warning: Hyper reference `Title' on page 410 undefined on input line 2479 0. Overfull \hbox (10.58418pt too wide) in paragraph at lines 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [410] Overfull \hbox (0.37231pt too wide) in paragraph at lines 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 [411] LaTeX Warning: Hyper reference `astDownsize' on page 412 undefined on input lin e 24790. Overfull \hbox (26.6159pt too wide) in paragraph at lines 24790--24790 [][]\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 24790--24790 [][]\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 [][]\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 24790--24790 []\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 24790--24790 \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 24790--24790 \T1/cmtt/m/n/10 For example, astOutlineD would be used to process " double" dat a, while astOutlineS Overfull \hbox (28.76947pt too wide) in paragraph at lines 24790--24790 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (7.7746pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" , " ubnd" and " inside" are changed from type " Overfull \hbox (34.01819pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 int" to type " int64_t" (defined in header file stdint.h). The function name is changed Overfull \hbox (19.22565pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 by inserting the digit " 8" before the trailing data type code. Thus, astOutline$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ [412] LaTeX Warning: Hyper reference `Region' on page 413 undefined on input line 248 56. Overfull \hbox (12.76088pt too wide) in paragraph at lines 24856--24856 \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 24856--24856 []\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 24856--24856 []\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 413 undefined on input line 248 56. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24856--24856 [][]\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 24856--24856 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [413] LaTeX Warning: Hyper reference `Table' on page 414 undefined on input line 2491 7. LaTeX Warning: Hyper reference `Nparameter' on page 414 undefined on input line 24917. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24917--24917 \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 24917--24917 [][]\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 24917--24917 \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 24917--24917 \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 24917--24917 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [414] LaTeX Warning: Hyper reference `PcdMap' on page 415 undefined on input line 250 20. LaTeX Warning: Hyper reference `Mapping' on page 415 undefined on input line 25 020. LaTeX Warning: Hyper reference `Disco' on page 415 undefined on input line 2502 0. LaTeX Warning: Hyper reference `astInvert' on page 415 undefined on input line 25020. Overfull \hbox (9.50914pt too wide) in paragraph at lines 25020--25020 []\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 25020--25020 \T1/cmtt/m/n/10 The distortion coefficient. Negative values give barrel distort ion, positive LaTeX Warning: Hyper reference `astSet' on page 415 undefined on input line 250 20. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25020--25020 \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 25020--25020 \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 25020--25020 \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 25020--25020 [] \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 25020--25020 \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 25020--25020 \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 415 undefined on input line 250 20. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25020--25020 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [415] Overfull \hbox (2.26344pt too wide) in paragraph at lines 25020--25020 []\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 25020--25020 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [416] LaTeX Warning: Hyper reference `Frame' on page 417 undefined on input line 2505 9. LaTeX Warning: Hyper reference `Naxes' on page 417 undefined on input line 2505 9. Overfull \hbox (0.10988pt too wide) in paragraph at lines 25059--25059 \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 25059--25059 \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 25059--25059 [][]\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 25059--25059 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [417] LaTeX Warning: Hyper reference `PermMap' on page 418 undefined on input line 25 197. LaTeX Warning: Hyper reference `Mapping' on page 418 undefined on input line 25 197. Overfull \hbox (5.09898pt too wide) in paragraph at lines 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 \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 25197--25197 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [418] LaTeX Warning: Hyper reference `astSet' on page 419 undefined on input line 251 97. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 [] \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 25197--25197 \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 25197--25197 \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 25197--25197 [][]\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 25197--25197 \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 25197--25197 [][]\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 25197--25197 \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 25197--25197 \T1/cmtt/m/n/10 to supply coordinate permutation arrays that achieve whatever e ffect is desired. LaTeX Warning: Hyper reference `Object' on page 419 undefined on input line 251 97. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25197--25197 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [419] LaTeX Warning: Hyper reference `Frame' on page 420 undefined on input line 2530 9. LaTeX Warning: Hyper reference `Title' on page 420 undefined on input line 2530 9. LaTeX Warning: Hyper reference `Mapping' on page 420 undefined on input line 25 309. Overfull \hbox (13.6056pt too wide) in paragraph at lines 25309--25309 []\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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 420 undefined on input line 25 309. LaTeX Warning: Hyper reference `UnitMap' on page 420 undefined on input line 25 309. Overfull \hbox (10.60732pt too wide) in paragraph at lines 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 []\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 25309--25309 LaTeX Warning: Hyper reference `SkyFrame' on page 420 undefined on input line 2 5309. Overfull \hbox (23.25832pt too wide) in paragraph at lines 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 420 undefined on input line 2 5309. Overfull \hbox (2.52588pt too wide) in paragraph at lines 25309--25309 \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 420 undefined on input line 253 09. LaTeX Warning: Hyper reference `Box' on page 420 undefined on input line 25309. LaTeX Warning: Hyper reference `Circle' on page 420 undefined on input line 253 09. Overfull \hbox (39.2669pt too wide) in paragraph at lines 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [420] LaTeX Warning: Hyper reference `astCopy' on page 421 undefined on input line 25 309. Overfull \hbox (26.6159pt too wide) in paragraph at lines 25309--25309 [][]\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 25309--25309 \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 421 undefined on input line 253 09. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25309--25309 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [421] LaTeX Warning: Hyper reference `Plot' on page 422 undefined on input line 25482 . LaTeX Warning: Hyper reference `FrameSet' on page 422 undefined on input line 2 5482. LaTeX Warning: Hyper reference `Frame' on page 422 undefined on input line 2548 2. LaTeX Warning: Hyper reference `Mapping' on page 422 undefined on input line 25 482. LaTeX Warning: Hyper reference `astCurve' on page 422 undefined on input line 2 5482. LaTeX Warning: Hyper reference `astMark' on page 422 undefined on input line 25 482. LaTeX Warning: Hyper reference `astText' on page 422 undefined on input line 25 482. LaTeX Warning: Hyper reference `astGridLine' on page 422 undefined on input lin e 25482. LaTeX Warning: Hyper reference `astGrid' on page 422 undefined on input line 25 482. LaTeX Warning: Hyper reference `Current' on page 422 undefined on input line 25 482. LaTeX Warning: Hyper reference `astClip' on page 422 undefined on input line 25 482. Overfull \hbox (7.93452pt too wide) in paragraph at lines 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 422 undefined on input line 254 82. LaTeX Warning: Hyper reference `Label(axis)' on page 422 undefined on input lin e 25482. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [422] Overfull \hbox (5.3586pt too wide) in paragraph at lines 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 423 undefined on input line 254 82. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [] \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 25482--25482 \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 25482--25482 \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 423 undefined on input line 25482 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 423 undefined on input line 2548 2. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [423] LaTeX Warning: Hyper reference `Plot3D' on page 424 undefined on input line 256 18. LaTeX Warning: Hyper reference `Plot' on page 424 undefined on input line 25618 . Overfull \hbox (28.9294pt too wide) in paragraph at lines 25618--25618 []\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 424 undefined on input line 2561 8. LaTeX Warning: Hyper reference `FrameSet' on page 424 undefined on input line 2 5618. Overfull \hbox (1.94693pt too wide) in paragraph at lines 25618--25618 \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 25618--25618 \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 25618--25618 \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 424 undefined on input line 256 18. LaTeX Warning: Hyper reference `Label(axis)' on page 424 undefined on input lin e 25618. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25618--25618 []\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 []\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 424 undefined on input line 256 18. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [] \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 25618--25618 \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 25618--25618 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [424] LaTeX Warning: Hyper reference `Base' on page 425 undefined on input line 25618 . Overfull \hbox (0.10988pt too wide) in paragraph at lines 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 425 undefined on input line 2561 8. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 25618--25618 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [425] LaTeX Warning: Hyper reference `Region' on page 426 undefined on input line 256 75. Overfull \hbox (26.35347pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 Pointer to an array holding the axis values of the point to be tested. The number Overfull \hbox (7.19565pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 of values in this array should match the number of axes in the supplied Region. Underfull \hbox (badness 10000) in paragraph at lines 25675--25675 LaTeX Warning: Hyper reference `Mapping' on page 426 undefined on input line 25 675. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25675--25675 [][]\T1/cmtt/m/n/10 If many points need to be tested, then it is usually more e fficient to use the Overfull \hbox (10.86975pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 Region as a Mapping to transform all the points. This can be do ne using one of Overfull \hbox (6.57465pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 the Mapping transformation methods (astTran$\OML/zplm/m/it/10 < $\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ). If a transformed axis value [426] LaTeX Warning: Hyper reference `PointList' on page 427 undefined on input line 25808. LaTeX Warning: Hyper reference `Region' on page 427 undefined on input line 258 08. LaTeX Warning: Hyper reference `Frame' on page 427 undefined on input line 2580 8. Overfull \hbox (34.17812pt too wide) in paragraph at lines 25808--25808 []\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 25808--25808 \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 25808--25808 \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 427 undefined on input line 2580 8. Overfull \hbox (0.10988pt too wide) in paragraph at lines 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \T1/cmtt/m/n/10 uncertainty Region then represents the uncertainty in the posit ion. The uncertainty LaTeX Warning: Hyper reference `Box' on page 427 undefined on input line 25808. LaTeX Warning: Hyper reference `Circle' on page 427 undefined on input line 258 08. LaTeX Warning: Hyper reference `Ellipse' on page 427 undefined on input line 25 808. LaTeX Warning: Hyper reference `Prism' on page 427 undefined on input line 2580 8. LaTeX Warning: Hyper reference `Object' on page 427 undefined on input line 258 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25808--25808 []\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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 427 undefined on input line 25808. LaTeX Warning: Hyper reference `astSimplify' on page 427 undefined on input lin e 25808. Overfull \hbox (5.3586pt too wide) in paragraph at lines 25808--25808 []\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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [427] LaTeX Warning: Hyper reference `astSet' on page 428 undefined on input line 258 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 [] \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 25808--25808 \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 25808--25808 \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 25808--25808 [][]\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 25808--25808 []\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 25808--25808 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [428] LaTeX Warning: Hyper reference `PolyMap' on page 429 undefined on input line 25 885. Overfull \hbox (29.14058pt too wide) in paragraph at lines 25885--25885 []\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 429 undefined on input line 25 885. Overfull \hbox (17.69308pt too wide) in paragraph at lines 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 []\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 25885--25885 \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 25885--25885 \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 25885--25885 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [429] LaTeX Warning: Hyper reference `Plot' on page 430 undefined on input line 25962 . LaTeX Warning: Hyper reference `astCurve' on page 430 undefined on input line 2 5962. LaTeX Warning: Hyper reference `Mapping' on page 430 undefined on input line 25 962. LaTeX Warning: Hyper reference `astClip' on page 430 undefined on input line 25 962. Overfull \hbox (18.43196pt too wide) in paragraph at lines 25962--25962 []\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 430 undefined on input line 2596 2. LaTeX Warning: Hyper reference `Naxes' on page 430 undefined on input line 2596 2. Overfull \hbox (21.10475pt too wide) in paragraph at lines 25962--25962 \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 25962--25962 \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 25962--25962 \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 25962--25962 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.09962pt too wide) in paragraph at lines 25962--25962 [] \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 25962--25962 \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 25962--25962 \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 25962--25962 \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 25962--25962 [][]\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 430 undefined on input lin e 25962. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25962--25962 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [430] LaTeX Warning: Hyper reference `PolyMap' on page 431 undefined on input line 26 089. LaTeX Warning: Hyper reference `Mapping' on page 431 undefined on input line 26 089. LaTeX Warning: Hyper reference `IterInverse' on page 431 undefined on input lin e 26089. Overfull \hbox (12.97206pt too wide) in paragraph at lines 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [431] LaTeX Warning: Hyper reference `astSet' on page 432 undefined on input line 260 89. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 [] \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 26089--26089 \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 26089--26089 \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 432 undefined on input line 260 89. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26089--26089 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [432] LaTeX Warning: Hyper reference `PolyMap' on page 433 undefined on input line 26 264. LaTeX Warning: Hyper reference `Mapping' on page 433 undefined on input line 26 264. Overfull \hbox (31.86462pt too wide) in paragraph at lines 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [433] LaTeX Warning: Hyper reference `Nin' on page 434 undefined on input line 26264. LaTeX Warning: Hyper reference `Nout' on page 434 undefined on input line 26264 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 434 undefined on input line 2 6264. Overfull \hbox (2.001pt too wide) in paragraph at lines 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 434 undefined on input lin e 26264. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26264--26264 [][]\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 26264--26264 \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 26264--26264 \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 26264--26264 [][]\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 434 undefined on input line 262 64. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26264--26264 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [434] LaTeX Warning: Hyper reference `Polygon' on page 435 undefined on input line 26 409. LaTeX Warning: Hyper reference `Frame' on page 435 undefined on input line 2640 9. LaTeX Warning: Hyper reference `SkyFrame' on page 435 undefined on input line 2 6409. Overfull \hbox (50.13545pt too wide) in paragraph at lines 26409--26409 []\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 435 undefined on input line 264 09. Overfull \hbox (5.3586pt too wide) in paragraph at lines 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 435 undefined on input line 26409. LaTeX Warning: Hyper reference `Circle' on page 435 undefined on input line 264 09. LaTeX Warning: Hyper reference `Ellipse' on page 435 undefined on input line 26 409. LaTeX Warning: Hyper reference `Prism' on page 435 undefined on input line 2640 9. LaTeX Warning: Hyper reference `Object' on page 435 undefined on input line 264 09. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26409--26409 []\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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [435] LaTeX Warning: Hyper reference `astOverlap' on page 436 undefined on input line 26409. LaTeX Warning: Hyper reference `astSimplify' on page 436 undefined on input lin e 26409. Overfull \hbox (5.3586pt too wide) in paragraph at lines 26409--26409 []\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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 436 undefined on input line 264 09. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 [] \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 26409--26409 \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 26409--26409 \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 26409--26409 [][]\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 26409--26409 []\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 26409--26409 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [436] LaTeX Warning: Hyper reference `Prism' on page 437 undefined on input line 2648 8. LaTeX Warning: Hyper reference `Region' on page 437 undefined on input line 264 88. LaTeX Warning: Hyper reference `Circle' on page 437 undefined on input line 264 88. LaTeX Warning: Hyper reference `Interval' on page 437 undefined on input line 2 6488. Overfull \hbox (9.9315pt too wide) in paragraph at lines 26488--26488 []\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 437 undefined on input line 264 88. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26488--26488 \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 26488--26488 \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 26488--26488 \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 26488--26488 [] \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 26488--26488 \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 26488--26488 \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 26488--26488 [][]\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 26488--26488 \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 437 undefined on input line 264 88. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26488--26488 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [437] LaTeX Warning: Hyper reference `Table' on page 438 undefined on input line 2650 8. [438] LaTeX Warning: Hyper reference `FitsChan' on page 439 undefined on input line 2 6530. [439] LaTeX Warning: Hyper reference `FitsChan' on page 440 undefined on input line 2 6576. LaTeX Warning: Hyper reference `Card' on page 440 undefined on input line 26576 . LaTeX Warning: Hyper reference `astRead' on page 440 undefined on input line 26 576. Overfull \hbox (0.37231pt too wide) in paragraph at lines 26576--26576 \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 26576--26576 \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 26576--26576 \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 26576--26576 \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 26576--26576 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [440] LaTeX Warning: Hyper reference `Channel' on page 441 undefined on input line 26 620. LaTeX Warning: Hyper reference `astChannelData' on page 441 undefined on input line 26620. Overfull \hbox (47.34834pt too wide) in paragraph at lines 26620--26620 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [441] Overfull \hbox (15.8076pt too wide) in paragraph at lines 26678--26678 []\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 442 undefined on input line 26678. Overfull \hbox (22.67937pt too wide) in paragraph at lines 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [442] LaTeX Warning: Hyper reference `FitsChan' on page 443 undefined on input line 2 6731. LaTeX Warning: Hyper reference `Card' on page 443 undefined on input line 26731 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 [][]\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 26731--26731 \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 26731--26731 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [443] LaTeX Warning: Hyper reference `FitsChan' on page 444 undefined on input line 2 6785. LaTeX Warning: Hyper reference `astRead' on page 444 undefined on input line 26 785. LaTeX Warning: Hyper reference `FitsTable' on page 444 undefined on input line 26785. Overfull \hbox (52.8595pt too wide) in paragraph at lines 26785--26785 \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 26785--26785 \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 26785--26785 \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 444 undefined on input li ne 26785. LaTeX Warning: Hyper reference `astPutTables' on page 444 undefined on input li ne 26785. [444] LaTeX Warning: Hyper reference `FitsTable' on page 445 undefined on input line 26831. LaTeX Warning: Hyper reference `FitsChan' on page 445 undefined on input line 2 6831. LaTeX Warning: Hyper reference `Table' on page 445 undefined on input line 2683 1. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26831--26831 \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 26831--26831 \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 26831--26831 \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 26831--26831 [][]\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 26831--26831 [][]\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 26831--26831 \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 26831--26831 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [445] LaTeX Warning: Hyper reference `FitsChan' on page 446 undefined on input line 2 6889. LaTeX Warning: Hyper reference `astRead' on page 446 undefined on input line 26 889. LaTeX Warning: Hyper reference `KeyMap' on page 446 undefined on input line 268 89. LaTeX Warning: Hyper reference `FitsTable' on page 446 undefined on input line 26889. Overfull \hbox (26.6159pt too wide) in paragraph at lines 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 446 undefined on input li ne 26889. Overfull \hbox (22.9418pt too wide) in paragraph at lines 26889--26889 [][]\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 446 undefined on input lin e 26889. Overfull \hbox (0.37231pt too wide) in paragraph at lines 26889--26889 [][]\T1/cmtt/m/n/10 The astPutTable method provides a simpler means of adding a single table to a [446] LaTeX Warning: Hyper reference `Mapping' on page 447 undefined on input line 27 004. Overfull \hbox (15.85886pt too wide) in paragraph at lines 27004--27004 []\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 447 undefined on input line 27004. Overfull \hbox (26.6159pt too wide) in paragraph at lines 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.10988pt too wide) in paragraph at lines 27004--27004 [] \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 27004--27004 \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.3586pt too wide) in paragraph at lines 27004--27004 [] \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 27004--27004 \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 447 undefined on input line 27004 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 27004--27004 [] \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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 []\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 27004--27004 \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 27004--27004 \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 27004--27004 \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 447 undefined on input line 27004. Overfull \hbox (0.37231pt too wide) in paragraph at lines 27004--27004 [][]\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 27004--27004 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using astInvert before invoking [447] Overfull \hbox (26.35347pt too wide) in paragraph at lines 27004--27004 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [448] LaTeX Warning: Hyper reference `Mapping' on page 449 undefined on input line 27 073. Overfull \hbox (21.10475pt too wide) in paragraph at lines 27073--27073 [] \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 27073--27073 \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 27073--27073 \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 27073--27073 \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 27073--27073 \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 27073--27073 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [449] LaTeX Warning: Hyper reference `RateMap' on page 450 undefined on input line 27 173. LaTeX Warning: Hyper reference `Mapping' on page 450 undefined on input line 27 173. Overfull \hbox (4.4716pt too wide) in paragraph at lines 27173--27173 []\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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 \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 450 undefined on input line 271 73. Overfull \hbox (10.86975pt too wide) in paragraph at lines 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 [] \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 27173--27173 \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 27173--27173 \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 450 undefined on input line 27 173. Overfull \hbox (10.60732pt too wide) in paragraph at lines 27173--27173 [][]\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 27173--27173 \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 27173--27173 \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 27173--27173 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [450] LaTeX Warning: Hyper reference `Object' on page 451 undefined on input line 271 73. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27173--27173 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [451] LaTeX Warning: Hyper reference `Object' on page 452 undefined on input line 272 41. LaTeX Warning: Hyper reference `Channel' on page 452 undefined on input line 27 241. LaTeX Warning: Hyper reference `FitsChan' on page 452 undefined on input line 2 7241. LaTeX Warning: Hyper reference `astRetainFits' on page 452 undefined on input l ine 27241. Overfull \hbox (18.0096pt too wide) in paragraph at lines 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 452 undefined on input line 2 7241. LaTeX Warning: Hyper reference `Region' on page 452 undefined on input line 272 41. LaTeX Warning: Hyper reference `KeyMap' on page 452 undefined on input line 272 41. LaTeX Warning: Hyper reference `StcsArea' on page 452 undefined on input line 2 7241. LaTeX Warning: Hyper reference `StcsCoords' on page 452 undefined on input line 27241. LaTeX Warning: Hyper reference `StcsProps' on page 452 undefined on input line 27241. Overfull \hbox (17.74716pt too wide) in paragraph at lines 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 [][]\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 27241--27241 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [452] LaTeX Warning: Hyper reference `FitsChan' on page 453 undefined on input line 2 7283. Overfull \hbox (0.37231pt too wide) in paragraph at lines 27283--27283 [][]\T1/cmtt/m/n/10 This function returns without action if no source function was specified when LaTeX Warning: Hyper reference `SourceFile' on page 453 undefined on input line 27283. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27283--27283 [][]\T1/cmtt/m/n/10 The SourceFile attribute is ignored by this function. New c ards are read from [453] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. LaTeX Warning: Hyper reference `Mapping' on page 454 undefined on input line 27 806. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 454 undefined on in put line 27806. Overfull \hbox (6.0526pt too wide) in paragraph at lines 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 > $ [454] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 \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 455 undefined on input line 27806. LaTeX Warning: Hyper reference `Nout' on page 455 undefined on input line 27806 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 [] \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [455] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (15.85603pt too wide) in paragraph at lines 27806--27806 [] \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [456] Overfull \hbox (47.61078pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [457] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 458 undefined on in put line 27806. Overfull \hbox (41.17413pt too wide) in paragraph at lines 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 [][]\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [458] Overfull \hbox (10.86975pt too wide) in paragraph at lines 27806--27806 [][]\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [459] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 460 undefined on input line 28408. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 460 undefined on in put line 28408. Overfull \hbox (21.79875pt too wide) in paragraph at lines 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 460 undefined on input line 28 408. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 \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 460 undefined on input line 28408. LaTeX Warning: Hyper reference `Nout' on page 460 undefined on input line 28408 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [460] Overfull \hbox (5.3586pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [] \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [461] Overfull \hbox (15.85603pt too wide) in paragraph at lines 28408--28408 [] \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [462] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 [463] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [464] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 []\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 28408--28408 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [465] Overfull \hbox (7.51216pt too wide) in paragraph at lines 28408--28408 []\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 28408--28408 []\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 28408--28408 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [466] LaTeX Warning: Hyper reference `Region' on page 467 undefined on input line 284 32. LaTeX Warning: Hyper reference `Plot' on page 467 undefined on input line 28432 . [467] LaTeX Warning: Hyper reference `Mapping' on page 468 undefined on input line 28 511. LaTeX Warning: Hyper reference `Frame' on page 468 undefined on input line 2851 1. LaTeX Warning: Hyper reference `FrameSet' on page 468 undefined on input line 2 8511. LaTeX Warning: Hyper reference `Nframe' on page 468 undefined on input line 285 11. Overfull \hbox (0.10988pt too wide) in paragraph at lines 28511--28511 \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 28511--28511 \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 28511--28511 \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 28511--28511 \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 28511--28511 [][]\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 28511--28511 [][]\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 28511--28511 \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 468 undefined on input line 28511. LaTeX Warning: Hyper reference `Nout' on page 468 undefined on input line 28511 . Overfull \hbox (20.31744pt too wide) in paragraph at lines 28511--28511 [][]\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 28511--28511 \T1/cmtt/m/n/10 and the number of output coordinate values generated (its Nout attribute) must LaTeX Warning: Hyper reference `astPermAxes' on page 468 undefined on input lin e 28511. Overfull \hbox (10.60732pt too wide) in paragraph at lines 28511--28511 [][]\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 28511--28511 \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 468 undefined on input lin e 28511. LaTeX Warning: Hyper reference `astRemoveFrame' on page 468 undefined on input line 28511. Overfull \hbox (23.99155pt too wide) in paragraph at lines 28511--28511 [][]\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 28511--28511 \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 468 undefined on input line 28 511. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28511--28511 [][]\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 28511--28511 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [468] LaTeX Warning: Hyper reference `Table' on page 469 undefined on input line 2854 0. Overfull \hbox (17.43065pt too wide) in paragraph at lines 28540--28540 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [469] LaTeX Warning: Hyper reference `Frame' on page 470 undefined on input line 2859 9. LaTeX Warning: Hyper reference `FrameSet' on page 470 undefined on input line 2 8599. LaTeX Warning: Hyper reference `Nframe' on page 470 undefined on input line 285 99. Overfull \hbox (15.85603pt too wide) in paragraph at lines 28599--28599 \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 28599--28599 \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 28599--28599 [][]\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 28599--28599 \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 28599--28599 [][]\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 28599--28599 [][]\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 470 undefined on input line 28599 . LaTeX Warning: Hyper reference `Current' on page 470 undefined on input line 28 599. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28599--28599 [][]\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 28599--28599 \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 28599--28599 [][]\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 28599--28599 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [470] LaTeX Warning: Hyper reference `Table' on page 471 undefined on input line 2862 8. Overfull \hbox (33.1768pt too wide) in paragraph at lines 28628--28628 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [471] LaTeX Warning: Hyper reference `Mapping' on page 472 undefined on input line 28 711. LaTeX Warning: Hyper reference `CmpMap' on page 472 undefined on input line 287 11. LaTeX Warning: Hyper reference `Region' on page 472 undefined on input line 287 11. LaTeX Warning: Hyper reference `UnitMap' on page 472 undefined on input line 28 711. LaTeX Warning: Hyper reference `CmpFrame' on page 472 undefined on input line 2 8711. LaTeX Warning: Hyper reference `Frame' on page 472 undefined on input line 2871 1. Overfull \hbox (18.27203pt too wide) in paragraph at lines 28711--28711 \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 472 undefined on input line 2 8711. Overfull \hbox (44.51563pt too wide) in paragraph at lines 28711--28711 \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 28711--28711 \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 28711--28711 \T1/cmtt/m/n/10 any Frames which are instances of the Region class are replaced by the equivalent Frame. Overfull \hbox (25.09537pt too wide) in paragraph at lines 28711--28711 \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 472 undefined on input line 2 8711. Overfull \hbox (1.94693pt too wide) in paragraph at lines 28711--28711 [][]\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 28711--28711 \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 472 undefined on input line 28 711. Overfull \hbox (26.6159pt too wide) in paragraph at lines 28711--28711 [][]\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 28711--28711 \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 28711--28711 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 472 undefined on input line 287 11. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28711--28711 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [472] LaTeX Warning: Hyper reference `Table' on page 473 undefined on input line 2873 9. [473] LaTeX Warning: Hyper reference `FitsChan' on page 474 undefined on input line 2 8767. Overfull \hbox (21.10475pt too wide) in paragraph at lines 28767--28767 \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 28767--28767 \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 28767--28767 [474] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. LaTeX Warning: Hyper reference `Mapping' on page 475 undefined on input line 29 615. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 475 undefined on input line 29615. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 475 undefined on in put line 29615. Overfull \hbox (3.69067pt too wide) in paragraph at lines 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [475] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29615--29615 \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 29615--29615 \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 29615--29615 \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 476 undefined on input line 29615. LaTeX Warning: Hyper reference `Nout' on page 476 undefined on input line 29615 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [] \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [476] Overfull \hbox (52.8595pt too wide) in paragraph at lines 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (15.85603pt too wide) in paragraph at lines 29615--29615 [] \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [477] Overfull \hbox (5.3586pt too wide) in paragraph at lines 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [478] Overfull \hbox (26.35347pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [479] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [480] Overfull \hbox (56.1174pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [481] Overfull \hbox (21.36719pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 482 undefined on input line 29615. Overfull \hbox (47.61078pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 schemes described above). Other elements of the " params" array are available LaTeX Warning: Hyper reference `astUinterp' on page 482 undefined on input line 29615. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [482] Overfull \hbox (0.37231pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 []\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [483] Overfull \hbox (26.6159pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 on entry to this function. The number of such array elements is returned as the function Overfull \hbox (7.7746pt too wide) in paragraph at lines 29615--29615 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [484] Overfull \hbox (12.97206pt too wide) in paragraph at lines 29697--29697 []\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 485 undefined on input line 2969 7. LaTeX Warning: Hyper reference `Naxes' on page 485 undefined on input line 2969 7. Overfull \hbox (21.10475pt too wide) in paragraph at lines 29697--29697 \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 29697--29697 \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 29697--29697 \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 29697--29697 \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 29697--29697 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.60732pt too wide) in paragraph at lines 29697--29697 [] \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 29697--29697 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.60732pt too wide) in paragraph at lines 29697--29697 [] \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 29697--29697 \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 485 undefined on input lin e 29697. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29697--29697 [][]\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 29697--29697 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [485] LaTeX Warning: Hyper reference `FitsChan' on page 486 undefined on input line 2 9738. LaTeX Warning: Hyper reference `Object' on page 486 undefined on input line 297 38. LaTeX Warning: Hyper reference `astRead' on page 486 undefined on input line 29 738. LaTeX Warning: Hyper reference `Card' on page 486 undefined on input line 29738 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 29738--29738 [][]\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 29738--29738 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the Card attribute exceeds the numb er of cards in [486] LaTeX Warning: Hyper reference `Object' on page 487 undefined on input line 297 89. Overfull \hbox (16.11847pt too wide) in paragraph at lines 29789--29789 [][]\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 29789--29789 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [487] LaTeX Warning: Hyper reference `SelectorMap' on page 488 undefined on input lin e 29890. LaTeX Warning: Hyper reference `Mapping' on page 488 undefined on input line 29 890. LaTeX Warning: Hyper reference `Region' on page 488 undefined on input line 298 90. LaTeX Warning: Hyper reference `Frame' on page 488 undefined on input line 2989 0. LaTeX Warning: Hyper reference `Nin' on page 488 undefined on input line 29890. LaTeX Warning: Hyper reference `UnitMap' on page 488 undefined on input line 29 890. LaTeX Warning: Hyper reference `astSimplify' on page 488 undefined on input lin e 29890. Overfull \hbox (23.41824pt too wide) in paragraph at lines 29890--29890 []\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 29890--29890 \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 29890--29890 \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 29890--29890 \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 488 undefined on input line 298 90. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29890--29890 \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 29890--29890 \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 29890--29890 \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 29890--29890 [] \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 29890--29890 \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 29890--29890 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [488] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29890--29890 [][]\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 29890--29890 \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 489 undefined on input line 298 90. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29890--29890 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [489] LaTeX Warning: Hyper reference `Object' on page 490 undefined on input line 299 96. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29996--29996 \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 29996--29996 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " LaTeX Warning: Hyper reference `Report' on page 490 undefined on input line 299 96. LaTeX Warning: Hyper reference `Zoom' on page 490 undefined on input line 29996 . Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 490 undefined on input lin e 29996. Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 490 undefined on input line 2999 6. Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 29996--29996 [][]\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 29996--29996 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [490] Overfull \hbox (42.36206pt too wide) in paragraph at lines 29996--29996 [][]\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 29996--29996 \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 29996--29996 \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 29996--29996 [][]\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 29996--29996 \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 29996--29996 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [491] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. LaTeX Warning: Hyper reference `Object' on page 492 undefined on input line 300 68. Overfull \hbox (26.6159pt too wide) in paragraph at lines 30068--30068 \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 30068--30068 \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 30068--30068 \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 30068--30068 Underfull \hbox (badness 10000) in paragraph at lines 30068--30068 Underfull \hbox (badness 10000) in paragraph at lines 30068--30068 [] \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 30068--30068 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [492] LaTeX Warning: Hyper reference `Frame' on page 493 undefined on input line 3019 4. LaTeX Warning: Hyper reference `astFindFrame' on page 493 undefined on input li ne 30194. LaTeX Warning: Hyper reference `astConvert' on page 493 undefined on input line 30194. LaTeX Warning: Hyper reference `Mapping' on page 493 undefined on input line 30 194. LaTeX Warning: Hyper reference `FrameSet' on page 493 undefined on input line 3 0194. LaTeX Warning: Hyper reference `ZoomMap' on page 493 undefined on input line 30 194. LaTeX Warning: Hyper reference `Axis' on page 493 undefined on input line 30194 . LaTeX Warning: Hyper reference `SkyFrame' on page 493 undefined on input line 3 0194. Overfull \hbox (23.25832pt too wide) in paragraph at lines 30194--30194 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [493] LaTeX Warning: Hyper reference `SpecFrame' on page 494 undefined on input line 30194. Overfull \hbox (28.50703pt too wide) in paragraph at lines 30194--30194 \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 494 undefined on input line 30194. Overfull \hbox (28.50703pt too wide) in paragraph at lines 30194--30194 \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 494 undefined on input line 3 0194. Overfull \hbox (7.51216pt too wide) in paragraph at lines 30194--30194 \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 30194--30194 \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 30194--30194 \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 30194--30194 \T1/cmtt/m/n/10 through all references to the component Frames, not just those encapsulated within LaTeX Warning: Hyper reference `Region' on page 494 undefined on input line 301 94. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 494 undefined on input l ine 30194. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 494 undefined on input l ine 30194. Overfull \hbox (16.11847pt too wide) in paragraph at lines 30194--30194 [][]\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 30194--30194 \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 494 undefined on inpu t line 30194. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30194--30194 [][]\T1/cmtt/m/n/10 The astGetActiveUnit function can be used to retrieve the c urrent value of the [494] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. LaTeX Warning: Hyper reference `FitsChan' on page 495 undefined on input line 3 0344. Overfull \hbox (14.82803pt too wide) in paragraph at lines 30344--30344 []\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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [495] LaTeX Warning: Hyper reference `Card' on page 496 undefined on input line 30344 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 496 undefined on input lin e 30344. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30344--30344 [][]\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 496 undefined on input li ne 30344. Overfull \hbox (16.11847pt too wide) in paragraph at lines 30344--30344 [][]\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 496 undefined on input lin e 30344. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30344--30344 [][]\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 30344--30344 \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 30344--30344 [][]\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 30344--30344 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [496] LaTeX Warning: Hyper reference `FitsChan' on page 497 undefined on input line 3 0398. Overfull \hbox (10.60732pt too wide) in paragraph at lines 30398--30398 \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 30398--30398 \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 497 undefined on input line 30398 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [497] LaTeX Warning: Hyper reference `FitsChan' on page 498 undefined on input line 3 0470. Overfull \hbox (39.63802pt too wide) in paragraph at lines 30470--30470 []\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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 498 undefined on input line 30470 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 [][]\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 30470--30470 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [498] LaTeX Warning: Hyper reference `ast_link' on page 499 undefined on input line 3 0522. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30522--30522 \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 30522--30522 \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 30522--30522 \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 30522--30522 []\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 30522--30522 \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 30522--30522 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [499] LaTeX Warning: Hyper reference `RefRA' on page 500 undefined on input line 3056 6. LaTeX Warning: Hyper reference `RefDec' on page 500 undefined on input line 305 66. LaTeX Warning: Hyper reference `SkyFrame' on page 500 undefined on input line 3 0566. LaTeX Warning: Hyper reference `SpecFrame' on page 500 undefined on input line 30566. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30566--30566 \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 30566--30566 \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 30566--30566 \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 30566--30566 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (15.85603pt too wide) in paragraph at lines 30566--30566 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [500] LaTeX Warning: Hyper reference `astChannel' on page 501 undefined on input line 30604. LaTeX Warning: Hyper reference `astFitsChan' on page 501 undefined on input lin e 30604. LaTeX Warning: Hyper reference `astClearStatus' on page 501 undefined on input line 30604. Overfull \hbox (0.37231pt too wide) in paragraph at lines 30604--30604 [][]\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 30604--30604 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [501] LaTeX Warning: Hyper reference `Region' on page 502 undefined on input line 306 46. LaTeX Warning: Hyper reference `Box' on page 502 undefined on input line 30646. LaTeX Warning: Hyper reference `Circle' on page 502 undefined on input line 306 46. LaTeX Warning: Hyper reference `Ellipse' on page 502 undefined on input line 30 646. LaTeX Warning: Hyper reference `Prism' on page 502 undefined on input line 3064 6. Overfull \hbox (0.37231pt too wide) in paragraph at lines 30646--30646 \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 30646--30646 \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 30646--30646 \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 30646--30646 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [502] LaTeX Warning: Hyper reference `ShiftMap' on page 503 undefined on input line 3 0723. LaTeX Warning: Hyper reference `Mapping' on page 503 undefined on input line 30 723. Overfull \hbox (9.50914pt too wide) in paragraph at lines 30723--30723 []\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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 \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 503 undefined on input line 307 23. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 [] \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 30723--30723 \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 30723--30723 \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 503 undefined on input line 307 23. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30723--30723 [][]\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 30723--30723 []\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 30723--30723 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [503] LaTeX Warning: Hyper reference `Object' on page 504 undefined on input line 307 51. [504] LaTeX Warning: Hyper reference `FitsChan' on page 505 undefined on input line 3 0771. [505] LaTeX Warning: Hyper reference `Region' on page 506 undefined on input line 308 11. LaTeX Warning: Hyper reference `Frame' on page 506 undefined on input line 3081 1. LaTeX Warning: Hyper reference `MeshSize' on page 506 undefined on input line 3 0811. Overfull \hbox (42.09962pt too wide) in paragraph at lines 30811--30811 \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 30811--30811 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [506] LaTeX Warning: Hyper reference `Mapping' on page 507 undefined on input line 30 894. LaTeX Warning: Hyper reference `CmpMap' on page 507 undefined on input line 308 94. LaTeX Warning: Hyper reference `FrameSet' on page 507 undefined on input line 3 0894. LaTeX Warning: Hyper reference `Frame' on page 507 undefined on input line 3089 4. Overfull \hbox (44.51563pt too wide) in paragraph at lines 30894--30894 \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 507 undefined on input line 3089 4. Overfull \hbox (21.10475pt too wide) in paragraph at lines 30894--30894 [][]\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 30894--30894 \T1/cmtt/m/n/10 simplification. This is so that their individual identity is pr eserved. This LaTeX Warning: Hyper reference `astClone' on page 507 undefined on input line 3 0894. Overfull \hbox (12.44437pt too wide) in paragraph at lines 30894--30894 [][]\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 30894--30894 \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 507 undefined on input line 30 894. Overfull \hbox (26.6159pt too wide) in paragraph at lines 30894--30894 [][]\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 30894--30894 \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 30894--30894 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 507 undefined on input line 308 94. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30894--30894 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [507] LaTeX Warning: Hyper reference `SkyFrame' on page 508 undefined on input line 3 1023. LaTeX Warning: Hyper reference `Frame' on page 508 undefined on input line 3102 3. LaTeX Warning: Hyper reference `System' on page 508 undefined on input line 310 23. LaTeX Warning: Hyper reference `Equinox' on page 508 undefined on input line 31 023. LaTeX Warning: Hyper reference `Epoch' on page 508 undefined on input line 3102 3. LaTeX Warning: Hyper reference `SkyRefIs' on page 508 undefined on input line 3 1023. LaTeX Warning: Hyper reference `astFormat' on page 508 undefined on input line 31023. LaTeX Warning: Hyper reference `astSet' on page 508 undefined on input line 310 23. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 [] \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 31023--31023 \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 31023--31023 \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 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \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 31023--31023 \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 31023--31023 \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 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \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 31023--31023 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [508] Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 \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 31023--31023 [][]\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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 509 undefined on input lin e 31023. Overfull \hbox (21.36719pt too wide) in paragraph at lines 31023--31023 [][]\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 31023--31023 \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 509 undefined on input line 31023. LaTeX Warning: Hyper reference `AlignSystem' on page 509 undefined on input lin e 31023. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31023--31023 [][]\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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \T1/cmtt/m/n/10 will therefore fully reflect the relationship between positions on the sky measured LaTeX Warning: Hyper reference `Object' on page 509 undefined on input line 310 23. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31023--31023 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [509] LaTeX Warning: Hyper reference `Mapping' on page 510 undefined on input line 31 066. LaTeX Warning: Hyper reference `System' on page 510 undefined on input line 310 66. LaTeX Warning: Hyper reference `SkyFrame' on page 510 undefined on input line 3 1066. LaTeX Warning: Hyper reference `SkyRefIs' on page 510 undefined on input line 3 1066. LaTeX Warning: Hyper reference `UnitMap' on page 510 undefined on input line 31 066. LaTeX Warning: Hyper reference `Object' on page 510 undefined on input line 310 66. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31066--31066 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [510] LaTeX Warning: Hyper reference `SlaMap' on page 511 undefined on input line 312 86. LaTeX Warning: Hyper reference `astSlaMap' on page 511 undefined on input line 31286. LaTeX Warning: Hyper reference `Mapping' on page 511 undefined on input line 31 286. LaTeX Warning: Hyper reference `Invert' on page 511 undefined on input line 312 86. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31286--31286 [] \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 \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 511 undefined on input lin e 31286. Overfull \hbox (37.11334pt too wide) in paragraph at lines 31286--31286 [][]\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [511] Overfull \hbox (49.23947pt too wide) in paragraph at lines 31286--31286 []\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 []\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 [][]\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 31286--31286 [][]\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 31286--31286 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [512] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31286--31286 \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 31286--31286 \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 31286--31286 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [513] LaTeX Warning: Hyper reference `SlaMap' on page 514 undefined on input line 313 66. LaTeX Warning: Hyper reference `Mapping' on page 514 undefined on input line 31 366. LaTeX Warning: Hyper reference `astSlaAdd' on page 514 undefined on input line 31366. Overfull \hbox (10.60732pt too wide) in paragraph at lines 31366--31366 \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 514 undefined on input line 313 66. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31366--31366 \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 31366--31366 \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 31366--31366 \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 31366--31366 \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 31366--31366 [] \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 31366--31366 \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 31366--31366 \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 514 undefined on input line 31366. LaTeX Warning: Hyper reference `Nout' on page 514 undefined on input line 31366 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 31366--31366 [][]\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 31366--31366 \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 31366--31366 \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 514 undefined on input line 313 66. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31366--31366 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [514] LaTeX Warning: Hyper reference `SpecMap' on page 515 undefined on input line 31 647. LaTeX Warning: Hyper reference `astSpecMap' on page 515 undefined on input line 31647. LaTeX Warning: Hyper reference `Mapping' on page 515 undefined on input line 31 647. LaTeX Warning: Hyper reference `Invert' on page 515 undefined on input line 316 47. Overfull \hbox (6.88478pt too wide) in paragraph at lines 31647--31647 []\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 31647--31647 [] \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 LaTeX Warning: Hyper reference `astSimplify' on page 515 undefined on input lin e 31647. Overfull \hbox (37.11334pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 [][]\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 31647--31647 []\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 31647--31647 \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 31647--31647 \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 31647--31647 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [515] Overfull \hbox (5.62103pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [516] Overfull \hbox (33.43924pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 517 undefined on input line 3164 7. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [517] LaTeX Warning: Hyper reference `SpecFluxFrame' on page 518 undefined on input l ine 31732. LaTeX Warning: Hyper reference `SpecFrame' on page 518 undefined on input line 31732. LaTeX Warning: Hyper reference `FluxFrame' on page 518 undefined on input line 31732. LaTeX Warning: Hyper reference `Frame' on page 518 undefined on input line 3173 2. LaTeX Warning: Hyper reference `Plot' on page 518 undefined on input line 31732 . Overfull \hbox (18.64314pt too wide) in paragraph at lines 31732--31732 []\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 31732--31732 \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 518 undefined on input line 31 732. Overfull \hbox (28.19052pt too wide) in paragraph at lines 31732--31732 \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 31732--31732 \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 518 undefined on input line 317 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31732--31732 \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 31732--31732 \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 31732--31732 \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 31732--31732 [] \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 31732--31732 \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 31732--31732 \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 31732--31732 [][]\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 31732--31732 \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 31732--31732 \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 518 undefined on input line 317 32. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31732--31732 [][]\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 31732--31732 []\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 31732--31732 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [518] LaTeX Warning: Hyper reference `SpecFrame' on page 519 undefined on input line 31832. LaTeX Warning: Hyper reference `Frame' on page 519 undefined on input line 3183 2. LaTeX Warning: Hyper reference `System' on page 519 undefined on input line 318 32. LaTeX Warning: Hyper reference `SpecOrigin' on page 519 undefined on input line 31832. LaTeX Warning: Hyper reference `astSet' on page 519 undefined on input line 318 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 [] \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 31832--31832 \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 31832--31832 \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 519 undefined on input line 3 1832. Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 \T1/cmtt/m/n/10 system. The RestFreq attribute (rest frequency) is unspecified, so it will Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 519 undefined on input line 31832. LaTeX Warning: Hyper reference `RefRA' on page 519 undefined on input line 3183 2. LaTeX Warning: Hyper reference `RefDec' on page 519 undefined on input line 318 32. Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [519] LaTeX Warning: Hyper reference `astConvert' on page 520 undefined on input line 31832. LaTeX Warning: Hyper reference `AlignSystem' on page 520 undefined on input lin e 31832. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 520 undefined on input line 31832. Overfull \hbox (21.36719pt too wide) in paragraph at lines 31832--31832 [][]\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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \T1/cmtt/m/n/10 between positions measured in the two systems. In addition, any difference in LaTeX Warning: Hyper reference `Object' on page 520 undefined on input line 318 32. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31832--31832 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [520] LaTeX Warning: Hyper reference `SpecMap' on page 521 undefined on input line 31 948. LaTeX Warning: Hyper reference `Mapping' on page 521 undefined on input line 31 948. LaTeX Warning: Hyper reference `astSpecAdd' on page 521 undefined on input line 31948. Overfull \hbox (17.43065pt too wide) in paragraph at lines 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 521 undefined on input line 319 48. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 [] \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 31948--31948 \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 31948--31948 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [521] Overfull \hbox (12.44437pt too wide) in paragraph at lines 31948--31948 [][]\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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 522 undefined on input line 319 48. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31948--31948 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [522] LaTeX Warning: Hyper reference `SphMap' on page 523 undefined on input line 320 46. LaTeX Warning: Hyper reference `Mapping' on page 523 undefined on input line 32 046. LaTeX Warning: Hyper reference `astSet' on page 523 undefined on input line 320 46. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32046--32046 \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 32046--32046 \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 32046--32046 \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 32046--32046 [] \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 32046--32046 \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 32046--32046 \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 32046--32046 [][]\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 32046--32046 \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 32046--32046 \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 523 undefined on input line 32046. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32046--32046 [][]\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 523 undefined on input line 320 46. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32046--32046 [][]\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 32046--32046 []\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 32046--32046 \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 32046--32046 []\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 32046--32046 \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 32046--32046 []\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 32046--32046 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [523] [524] LaTeX Warning: Hyper reference `astClearStatus' on page 525 undefined on input line 32075. Overfull \hbox (42.36206pt too wide) in paragraph at lines 32075--32075 [][]\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 32075--32075 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [525] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 526 undefined on input line 32165. LaTeX Warning: Hyper reference `Stc' on page 526 undefined on input line 32165. Overfull \hbox (26.30504pt too wide) in paragraph at lines 32165--32165 []\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 526 undefined on input line 321 65. LaTeX Warning: Hyper reference `KeyMap' on page 526 undefined on input line 321 65. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 526 undefined on input line 321 65. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 [] \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 32165--32165 \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 32165--32165 \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 32165--32165 [][]\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 32165--32165 \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 526 undefined on input line 321 65. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32165--32165 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [526] [527] LaTeX Warning: Hyper reference `StcObsDataLocation' on page 528 undefined on in put line 32255. LaTeX Warning: Hyper reference `Stc' on page 528 undefined on input line 32255. Overfull \hbox (28.9294pt too wide) in paragraph at lines 32255--32255 []\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 528 undefined on input line 322 55. LaTeX Warning: Hyper reference `KeyMap' on page 528 undefined on input line 322 55. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 528 undefined on input line 322 55. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 [] \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 32255--32255 \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 32255--32255 \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 32255--32255 [][]\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 32255--32255 \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 528 undefined on input line 322 55. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32255--32255 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [528] [529] LaTeX Warning: Hyper reference `StcResourceProfile' on page 530 undefined on in put line 32353. LaTeX Warning: Hyper reference `Stc' on page 530 undefined on input line 32353. Overfull \hbox (28.9294pt too wide) in paragraph at lines 32353--32353 []\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 530 undefined on input line 323 53. LaTeX Warning: Hyper reference `KeyMap' on page 530 undefined on input line 323 53. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 530 undefined on input line 323 53. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 [] \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 32353--32353 \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 32353--32353 \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 32353--32353 [][]\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 32353--32353 \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 530 undefined on input line 323 53. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32353--32353 [][]\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 32353--32353 []\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 32353--32353 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] LaTeX Warning: Hyper reference `StcSearchLocation' on page 532 undefined on inp ut line 32451. LaTeX Warning: Hyper reference `Stc' on page 532 undefined on input line 32451. Overfull \hbox (23.68068pt too wide) in paragraph at lines 32451--32451 []\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 532 undefined on input line 324 51. LaTeX Warning: Hyper reference `KeyMap' on page 532 undefined on input line 324 51. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 532 undefined on input line 324 51. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 [] \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 32451--32451 \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 32451--32451 \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 32451--32451 [][]\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 32451--32451 \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 532 undefined on input line 324 51. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32451--32451 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [532] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32451--32451 []\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 32451--32451 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [533] LaTeX Warning: Hyper reference `StcsChan' on page 534 undefined on input line 3 2554. LaTeX Warning: Hyper reference `Channel' on page 534 undefined on input line 32 554. LaTeX Warning: Hyper reference `Object' on page 534 undefined on input line 325 54. LaTeX Warning: Hyper reference `astWrite' on page 534 undefined on input line 3 2554. LaTeX Warning: Hyper reference `XmlChan' on page 534 undefined on input line 32 554. LaTeX Warning: Hyper reference `SinkFile' on page 534 undefined on input line 3 2554. LaTeX Warning: Hyper reference `SourceFile' on page 534 undefined on input line 32554. Overfull \hbox (8.09445pt too wide) in paragraph at lines 32554--32554 []\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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 []\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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 []\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 534 undefined on input line 325 54. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 [] \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 32554--32554 \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 32554--32554 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [534] Overfull \hbox (8.24539pt too wide) in paragraph at lines 32554--32554 [][]\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 32554--32554 \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 32554--32554 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [535] LaTeX Warning: Hyper reference `astEscapes' on page 536 undefined on input line 32595. LaTeX Warning: Hyper reference `Plot' on page 536 undefined on input line 32595 . LaTeX Warning: Hyper reference `Escape' on page 536 undefined on input line 325 95. Overfull \hbox (2.52588pt too wide) in paragraph at lines 32595--32595 \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 32595--32595 \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 32595--32595 \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 32595--32595 \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 32595--32595 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [536] LaTeX Warning: Hyper reference `SwitchMap' on page 537 undefined on input line 32754. LaTeX Warning: Hyper reference `Mapping' on page 537 undefined on input line 32 754. LaTeX Warning: Hyper reference `Nin' on page 537 undefined on input line 32754. LaTeX Warning: Hyper reference `Nout' on page 537 undefined on input line 32754 . LaTeX Warning: Hyper reference `SelectorMap' on page 537 undefined on input lin e 32754. LaTeX Warning: Hyper reference `UnitMap' on page 537 undefined on input line 32 754. LaTeX Warning: Hyper reference `astSimplify' on page 537 undefined on input lin e 32754. Overfull \hbox (34.3893pt too wide) in paragraph at lines 32754--32754 []\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 [537] Overfull \hbox (65.9813pt too wide) in paragraph at lines 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 538 undefined on input line 327 54. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 [] \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 32754--32754 \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 32754--32754 \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 538 undefined on input line 32 754. Overfull \hbox (0.37231pt too wide) in paragraph at lines 32754--32754 [][]\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 32754--32754 \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 32754--32754 \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 32754--32754 \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 538 undefined on input line 327 54. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32754--32754 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [538] LaTeX Warning: Hyper reference `Table' on page 539 undefined on input line 3284 4. LaTeX Warning: Hyper reference `KeyMap' on page 539 undefined on input line 328 44. LaTeX Warning: Hyper reference `astAddColumn' on page 539 undefined on input li ne 32844. LaTeX Warning: Hyper reference `astAddParameter' on page 539 undefined on input line 32844. LaTeX Warning: Hyper reference `astSet' on page 539 undefined on input line 328 44. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32844--32844 \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 32844--32844 \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 32844--32844 \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 32844--32844 [] \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 32844--32844 \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 32844--32844 \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 539 undefined on input line 328 44. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32844--32844 [][]\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 32844--32844 []\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 32844--32844 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [539] LaTeX Warning: Hyper reference `FitsChan' on page 540 undefined on input line 3 2924. LaTeX Warning: Hyper reference `astRead' on page 540 undefined on input line 32 924. LaTeX Warning: Hyper reference `FrameSet' on page 540 undefined on input line 3 2924. LaTeX Warning: Hyper reference `TabOK' on page 540 undefined on input line 3292 4. LaTeX Warning: Hyper reference `astPutTables' on page 540 undefined on input li ne 32924. LaTeX Warning: Hyper reference `astPutTable' on page 540 undefined on input lin e 32924. Overfull \hbox (18.3807pt too wide) in paragraph at lines 32924--32924 []\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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 540 undefined on input line 32924. Overfull \hbox (31.60219pt too wide) in paragraph at lines 32924--32924 []\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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 []\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 540 undefined on inp ut line 32924. LaTeX Warning: Hyper reference `astChannelData' on page 540 undefined on input line 32924. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32924--32924 [][]\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 32924--32924 \T1/cmtt/m/n/10 table source function using the astPutChannelData function. The source function [540] LaTeX Warning: Hyper reference `Object' on page 541 undefined on input line 329 82. Overfull \hbox (26.6159pt too wide) in paragraph at lines 32982--32982 \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 32982--32982 \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 32982--32982 [][]\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 32982--32982 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [541] LaTeX Warning: Hyper reference `Moc' on page 542 undefined on input line 33033. LaTeX Warning: Hyper reference `MaxOrder' on page 542 undefined on input line 3 3033. Overfull \hbox (10.60732pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 The HEALPix order of the cell to test. Zero is returned if this is higher than Overfull \hbox (5.09616pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 The " npix" value identifying the cell to test (see the MOC rec ommendation for Overfull \hbox (21.36719pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 Indicates the value to return if the tested cell is not include d at the specified Overfull \hbox (39.2669pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 One if the specified cell is included in the Moc at the specifi ed order, of (if " parent" [542] LaTeX Warning: Hyper reference `FitsChan' on page 543 undefined on input line 3 3113. Overfull \hbox (7.19565pt too wide) in paragraph at lines 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 [][]\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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 [][]\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 33113--33113 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [543] LaTeX Warning: Hyper reference `Plot' on page 544 undefined on input line 33202 . Overfull \hbox (10.55888pt too wide) in paragraph at lines 33202--33202 []\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 33202--33202 \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 33202--33202 \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 544 undefined on input line 332 02. Overfull \hbox (5.3586pt too wide) in paragraph at lines 33202--33202 [] \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 []\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 33202--33202 [][]\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 33202--33202 [][]\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 33202--33202 \T1/cmtt/m/n/10 (or where the transformation into graphical coordinates yields coordinates containing LaTeX Warning: Hyper reference `astClip' on page 544 undefined on input line 33 202. LaTeX Warning: Hyper reference `Frame' on page 544 undefined on input line 3320 2. Overfull \hbox (0.37231pt too wide) in paragraph at lines 33202--33202 [][]\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 544 undefined on input lin e 33202. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33202--33202 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [544] LaTeX Warning: Hyper reference `Object' on page 545 undefined on input line 332 96. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33296--33296 [] \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 545 undefined on input line 33296. LaTeX Warning: Hyper reference `astLock' on page 545 undefined on input line 33 296. Overfull \hbox (18.0096pt too wide) in paragraph at lines 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 [][]\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 33296--33296 \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 33296--33296 [][]\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 33296--33296 \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 545 undefined on input line 3 3296. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33296--33296 []\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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 545 undefined on input line 3 3296. Overfull \hbox (28.76947pt too wide) in paragraph at lines 33296--33296 []\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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 545 undefined on input line 332 96. Overfull \hbox (44.25319pt too wide) in paragraph at lines 33296--33296 []\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 33296--33296 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [545] Overfull \hbox (28.76947pt too wide) in paragraph at lines 33296--33296 []\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 33296--33296 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [546] LaTeX Warning: Hyper reference `TimeMap' on page 547 undefined on input line 33 536. LaTeX Warning: Hyper reference `astTimeMap' on page 547 undefined on input line 33536. LaTeX Warning: Hyper reference `Mapping' on page 547 undefined on input line 33 536. LaTeX Warning: Hyper reference `Invert' on page 547 undefined on input line 335 36. Overfull \hbox (6.88478pt too wide) in paragraph at lines 33536--33536 []\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 33536--33536 [] \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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 \T1/cmtt/m/n/10 the conversion specified (see the " Available Conversions" sect ion). This array LaTeX Warning: Hyper reference `astSimplify' on page 547 undefined on input lin e 33536. Overfull \hbox (37.11334pt too wide) in paragraph at lines 33536--33536 [][]\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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 [][]\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 33536--33536 []\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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [547] Overfull \hbox (33.75575pt too wide) in paragraph at lines 33536--33536 \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 33536--33536 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [548] Overfull \hbox (43.93668pt too wide) in paragraph at lines 33536--33536 [][]\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 33536--33536 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [549] LaTeX Warning: Hyper reference `TimeFrame' on page 550 undefined on input line 33626. LaTeX Warning: Hyper reference `Frame' on page 550 undefined on input line 3362 6. LaTeX Warning: Hyper reference `System' on page 550 undefined on input line 336 26. LaTeX Warning: Hyper reference `TimeOrigin' on page 550 undefined on input line 33626. LaTeX Warning: Hyper reference `TimeScale' on page 550 undefined on input line 33626. LaTeX Warning: Hyper reference `astSet' on page 550 undefined on input line 336 26. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33626--33626 \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 33626--33626 \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 33626--33626 \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 33626--33626 \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 33626--33626 [] \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 33626--33626 \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 33626--33626 \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 550 undefined on input line 33626. LaTeX Warning: Hyper reference `AlignSystem' on page 550 undefined on input lin e 33626. LaTeX Warning: Hyper reference `AlignTimeScale' on page 550 undefined on input line 33626. Overfull \hbox (21.36719pt too wide) in paragraph at lines 33626--33626 [][]\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 33626--33626 \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 33626--33626 \T1/cmtt/m/n/10 they represent, together with any qualifying time scale, offset , unit, etc. The LaTeX Warning: Hyper reference `Object' on page 550 undefined on input line 336 26. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33626--33626 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [550] [551] LaTeX Warning: Hyper reference `TimeMap' on page 552 undefined on input line 33 708. LaTeX Warning: Hyper reference `Mapping' on page 552 undefined on input line 33 708. LaTeX Warning: Hyper reference `astTimeAdd' on page 552 undefined on input line 33708. Overfull \hbox (10.60732pt too wide) in paragraph at lines 33708--33708 \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 552 undefined on input line 337 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 [] \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 33708--33708 \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 33708--33708 \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 33708--33708 [][]\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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 552 undefined on input line 337 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33708--33708 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [552] LaTeX Warning: Hyper reference `Object' on page 553 undefined on input line 337 38. LaTeX Warning: Hyper reference `astFromString' on page 553 undefined on input l ine 33738. LaTeX Warning: Hyper reference `astFree' on page 553 undefined on input line 33 738. Overfull \hbox (23.25832pt too wide) in paragraph at lines 33738--33738 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [553] LaTeX Warning: Hyper reference `Mapping' on page 554 undefined on input line 33 806. Overfull \hbox (12.97206pt too wide) in paragraph at lines 33806--33806 []\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 33806--33806 \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 33806--33806 \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 33806--33806 \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 554 undefined on input line 33806. LaTeX Warning: Hyper reference `Nout' on page 554 undefined on input line 33806 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 33806--33806 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 1 for both its Nin and Nout attributes. Overfull \hbox (49.76434pt too wide) in paragraph at lines 33806--33806 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [554] LaTeX Warning: Hyper reference `Mapping' on page 555 undefined on input line 33 887. Overfull \hbox (10.3477pt too wide) in paragraph at lines 33887--33887 []\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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 555 undefined on input line 33887. LaTeX Warning: Hyper reference `Nout' on page 555 undefined on input line 33887 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 33887--33887 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 2 for both its Nin and Nout attributes. Overfull \hbox (49.76434pt too wide) in paragraph at lines 33887--33887 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [555] LaTeX Warning: Hyper reference `Mapping' on page 556 undefined on input line 34 059. Overfull \hbox (20.84514pt too wide) in paragraph at lines 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (15.85603pt too wide) in paragraph at lines 34059--34059 [] \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [556] Overfull \hbox (42.09962pt too wide) in paragraph at lines 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 557 undefined on input line 34059. LaTeX Warning: Hyper reference `Nout' on page 557 undefined on input line 34059 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 34059--34059 [][]\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 34059--34059 \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 34059--34059 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these Overfull \hbox (1.47614pt too wide) in paragraph at lines 34059--34059 []\T1/cmtt/m/n/10 If the output grid is so large that an integer pixel index, ( or a count of pixels) Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 could exceed the largest value that can be represented by a 4-b yte integer, then the Overfull \hbox (7.7746pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 alternative " 8-byte" interface for this function should be use d. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd" , " ubnd" , " outdim" are changed Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 from type " int" to type " int64_t" (defined in header file std int.h). The function Overfull \hbox (7.7746pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 name is changed by appending the digit " 8" to the name. Thus, astTranGrid becomes [557] LaTeX Warning: Hyper reference `TranMap' on page 558 undefined on input line 34 161. LaTeX Warning: Hyper reference `Mapping' on page 558 undefined on input line 34 161. Overfull \hbox (9.9315pt too wide) in paragraph at lines 34161--34161 []\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 34161--34161 \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 34161--34161 \T1/cmtt/m/n/10 Pointer to the second component Mapping, which defines the inve rse transformation. LaTeX Warning: Hyper reference `astSet' on page 558 undefined on input line 341 61. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34161--34161 \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 34161--34161 \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 34161--34161 \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 34161--34161 [] \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 34161--34161 \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 34161--34161 \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 558 undefined on input line 34161 . LaTeX Warning: Hyper reference `Nin' on page 558 undefined on input line 34161. Overfull \hbox (41.31232pt too wide) in paragraph at lines 34161--34161 [][]\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 34161--34161 \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 558 undefined on input line 34 161. Overfull \hbox (10.60732pt too wide) in paragraph at lines 34161--34161 [][]\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 34161--34161 \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 34161--34161 \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 34161--34161 \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 558 undefined on input line 341 61. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34161--34161 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [558] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34161--34161 []\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 34161--34161 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [559] LaTeX Warning: Hyper reference `Mapping' on page 560 undefined on input line 34 281. LaTeX Warning: Hyper reference `astTranP' on page 560 undefined on input line 3 4281. Overfull \hbox (7.72334pt too wide) in paragraph at lines 34281--34281 []\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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (57.84578pt too wide) in paragraph at lines 34281--34281 [] \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [560] LaTeX Warning: Hyper reference `Nin' on page 561 undefined on input line 34281. LaTeX Warning: Hyper reference `Nout' on page 561 undefined on input line 34281 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 34281--34281 [][]\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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these Overfull \hbox (49.76434pt too wide) in paragraph at lines 34281--34281 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (13.02332pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 Specifically, the arguments " npoint" , " indim" and " outdim" are changed from type Overfull \hbox (2.52588pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 " int" to type " int64_t" (defined in header file stdint.h). Th e function name is Overfull \hbox (2.52588pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 changed by appending the digit " 8" to the name. Thus, astTranN becomes astTranN8 Underfull \hbox (badness 10000) in paragraph at lines 34281--34281 [561] LaTeX Warning: Hyper reference `Mapping' on page 562 undefined on input line 34 387. LaTeX Warning: Hyper reference `astTranN' on page 562 undefined on input line 3 4387. Overfull \hbox (5.31017pt too wide) in paragraph at lines 34387--34387 []\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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 562 undefined on input line 34387. LaTeX Warning: Hyper reference `Nout' on page 562 undefined on input line 34387 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 34387--34387 [][]\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 34387--34387 \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 34387--34387 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these [562] Overfull \hbox (49.76434pt too wide) in paragraph at lines 34387--34387 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [563] LaTeX Warning: Hyper reference `astTuneC' on page 564 undefined on input line 3 4469. Overfull \hbox (0.10988pt too wide) in paragraph at lines 34469--34469 \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 34469--34469 \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 34469--34469 [][]\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 34469--34469 \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 34469--34469 LaTeX Warning: Hyper reference `Object' on page 564 undefined on input line 344 69. LaTeX Warning: Hyper reference `astDelete' on page 564 undefined on input line 34469. Overfull \hbox (2.001pt too wide) in paragraph at lines 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [564] LaTeX Warning: Hyper reference `astTune' on page 565 undefined on input line 34 582. Overfull \hbox (5.3586pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 [][]\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 34582--34582 \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 34582--34582 Overfull \hbox (7.51216pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 [565] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 [566] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 567 undefined on in put line 34790. Overfull \hbox (7.51216pt too wide) in paragraph at lines 34790--34790 []\T1/cmtt/m/n/10 void astUinterp( int ndim_in, const AstDim lbnd_in[], const A stDim ubnd_in[], const Overfull \hbox (9.68182pt too wide) in paragraph at lines 34790--34790 \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 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1 /cmtt/m/n/10 in_var[], AstDim npoint, const AstDim offset[], const Overfull \hbox (9.893pt too wide) in paragraph at lines 34790--34790 \T1/cmtt/m/n/10 double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 const coords[], co nst 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 X type$\OML/zplm/m/it/10 >$ Overfull \hbox (42.36206pt too wide) in paragraph at lines 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 [] \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [567] Overfull \hbox (21.36719pt too wide) in paragraph at lines 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [568] Overfull \hbox (14.44772pt too wide) in paragraph at lines 34790--34790 [][]\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 34790--34790 [][]\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 569 undefined on input li ne 34790. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34790--34790 [][]\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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [569] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 570 undefined on in put line 34881. Overfull \hbox (5.3586pt too wide) in paragraph at lines 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 [][]\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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 570 undefined on input li ne 34881. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34881--34881 [][]\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 34881--34881 \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 34881--34881 \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 34881--34881 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [570] [571] LaTeX Warning: Hyper reference `Frame' on page 572 undefined on input line 3517 9. LaTeX Warning: Hyper reference `astFormat' on page 572 undefined on input line 35179. Overfull \hbox (0.10988pt too wide) in paragraph at lines 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 572 undefined on input line 3 5179. Overfull \hbox (18.0096pt too wide) in paragraph at lines 35179--35179 \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 35179--35179 \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 572 undefined on input line 3 5179. LaTeX Warning: Hyper reference `Current' on page 572 undefined on input line 35 179. Overfull \hbox (44.25319pt too wide) in paragraph at lines 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [572] Overfull \hbox (18.74283pt too wide) in paragraph at lines 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [573] Overfull \hbox (10.86975pt too wide) in paragraph at lines 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [574] LaTeX Warning: Hyper reference `Format(axis)' on page 575 undefined on input li ne 35179. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35179--35179 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [575] LaTeX Warning: Hyper reference `UnitMap' on page 576 undefined on input line 35 240. LaTeX Warning: Hyper reference `Mapping' on page 576 undefined on input line 35 240. Overfull \hbox (0.10988pt too wide) in paragraph at lines 35240--35240 \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 576 undefined on input line 352 40. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35240--35240 \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 35240--35240 \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 35240--35240 \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 35240--35240 [] \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 35240--35240 \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 35240--35240 \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 576 undefined on input line 352 40. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35240--35240 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [576] LaTeX Warning: Hyper reference `UnitNormMap' on page 577 undefined on input lin e 35343. LaTeX Warning: Hyper reference `Nin' on page 577 undefined on input line 35343. Overfull \hbox (26.30504pt too wide) in paragraph at lines 35343--35343 []\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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 \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 577 undefined on input line 353 43. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 [] \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 35343--35343 \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 35343--35343 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [577] LaTeX Warning: Hyper reference `Object' on page 578 undefined on input line 353 43. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35343--35343 [][]\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 35343--35343 []\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 35343--35343 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [578] LaTeX Warning: Hyper reference `Object' on page 579 undefined on input line 354 05. LaTeX Warning: Hyper reference `astLock' on page 579 undefined on input line 35 405. Overfull \hbox (47.61078pt too wide) in paragraph at lines 35405--35405 \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 35405--35405 \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 35405--35405 [][]\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 35405--35405 \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 35405--35405 [][]\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 35405--35405 [][]\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 35405--35405 \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 35405--35405 [][]\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 35405--35405 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [579] LaTeX Warning: Hyper reference `Object' on page 580 undefined on input line 354 40. Overfull \hbox (12.76088pt too wide) in paragraph at lines 35440--35440 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [580] LaTeX Warning: Hyper reference `KeyMap' on page 581 undefined on input line 355 42. LaTeX Warning: Hyper reference `astRead' on page 581 undefined on input line 35 542. LaTeX Warning: Hyper reference `astWrite' on page 581 undefined on input line 3 5542. LaTeX Warning: Hyper reference `Channel' on page 581 undefined on input line 35 542. LaTeX Warning: Hyper reference `Strict' on page 581 undefined on input line 355 42. LaTeX Warning: Hyper reference `Object' on page 581 undefined on input line 355 42. Overfull \hbox (44.25319pt too wide) in paragraph at lines 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 []\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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 581 undefined on input line 3 5542. LaTeX Warning: Hyper reference `Warnings' on page 581 undefined on input line 3 5542. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35542--35542 \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 581 undefined on input line 35 542. Overfull \hbox (33.75575pt too wide) in paragraph at lines 35542--35542 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [581] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35542--35542 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [582] LaTeX Warning: Hyper reference `astOK' on page 583 undefined on input line 3559 5. LaTeX Warning: Hyper reference `astStatus' on page 583 undefined on input line 35595. LaTeX Warning: Hyper reference `astClearStatus' on page 583 undefined on input line 35595. Overfull \hbox (0.37231pt too wide) in paragraph at lines 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [583] LaTeX Warning: Hyper reference `WcsMap' on page 584 undefined on input line 357 79. LaTeX Warning: Hyper reference `Mapping' on page 584 undefined on input line 35 779. LaTeX Warning: Hyper reference `WcsType' on page 584 undefined on input line 35 779. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 584 undefined on input line 35779. LaTeX Warning: Hyper reference `PVi_m' on page 584 undefined on input line 3577 9. Overfull \hbox (21.05632pt too wide) in paragraph at lines 35779--35779 []\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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [584] Overfull \hbox (15.85603pt too wide) in paragraph at lines 35779--35779 \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 585 undefined on input line 357 79. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 []\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 35779--35779 \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 35779--35779 \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 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 35779--35779 Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 585 undefined on input line 35779. Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 copied unchanged. Projection parameter 1 associatyed with the l atitude axis Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 \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 35779--35779 \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 35779--35779 \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 585 undefined on input line 35779. LaTeX Warning: Hyper reference `Invert' on page 585 undefined on input line 357 79. Overfull \hbox (37.11334pt too wide) in paragraph at lines 35779--35779 [][]\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 35779--35779 \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 35779--35779 \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 35779--35779 [][]\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 35779--35779 \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 35779--35779 [][]\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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [585] LaTeX Warning: Hyper reference `Object' on page 586 undefined on input line 357 79. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35779--35779 [][]\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 35779--35779 []\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 35779--35779 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [586] LaTeX Warning: Hyper reference `WinMap' on page 587 undefined on input line 358 85. LaTeX Warning: Hyper reference `Mapping' on page 587 undefined on input line 35 885. Overfull \hbox (23.4695pt too wide) in paragraph at lines 35885--35885 []\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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 587 undefined on input line 358 85. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 [] \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 35885--35885 \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 35885--35885 \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 587 undefined on input line 358 85. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35885--35885 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [587] Overfull \hbox (2.26344pt too wide) in paragraph at lines 35885--35885 []\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 35885--35885 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [588] LaTeX Warning: Hyper reference `Object' on page 589 undefined on input line 359 48. LaTeX Warning: Hyper reference `Channel' on page 589 undefined on input line 35 948. LaTeX Warning: Hyper reference `FitsChan' on page 589 undefined on input line 3 5948. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35948--35948 \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 35948--35948 \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 35948--35948 \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 35948--35948 [][]\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 35948--35948 [][]\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 35948--35948 \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 35948--35948 \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 35948--35948 \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 35948--35948 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [589] LaTeX Warning: Hyper reference `FitsChan' on page 590 undefined on input line 3 5985. LaTeX Warning: Hyper reference `SinkFile' on page 590 undefined on input line 3 5985. LaTeX Warning: Hyper reference `astEmptyFits' on page 590 undefined on input li ne 35985. Overfull \hbox (10.60732pt too wide) in paragraph at lines 35985--35985 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [590] LaTeX Warning: Hyper reference `XmlChan' on page 591 undefined on input line 36 086. LaTeX Warning: Hyper reference `Channel' on page 591 undefined on input line 36 086. LaTeX Warning: Hyper reference `Object' on page 591 undefined on input line 360 86. LaTeX Warning: Hyper reference `astWrite' on page 591 undefined on input line 3 6086. LaTeX Warning: Hyper reference `SinkFile' on page 591 undefined on input line 3 6086. LaTeX Warning: Hyper reference `SourceFile' on page 591 undefined on input line 36086. Overfull \hbox (8.56807pt too wide) in paragraph at lines 36086--36086 []\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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 []\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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 []\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 591 undefined on input line 360 86. Overfull \hbox (10.86975pt too wide) in paragraph at lines 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 [] \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 36086--36086 \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 36086--36086 \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 36086--36086 [][]\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 36086--36086 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [591] Overfull \hbox (5.62103pt too wide) in paragraph at lines 36086--36086 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [592] LaTeX Warning: Hyper reference `YamlChan' on page 593 undefined on input line 3 6189. LaTeX Warning: Hyper reference `Channel' on page 593 undefined on input line 36 189. LaTeX Warning: Hyper reference `Object' on page 593 undefined on input line 361 89. LaTeX Warning: Hyper reference `astWrite' on page 593 undefined on input line 3 6189. LaTeX Warning: Hyper reference `SinkFile' on page 593 undefined on input line 3 6189. LaTeX Warning: Hyper reference `SourceFile' on page 593 undefined on input line 36189. Overfull \hbox (8.09445pt too wide) in paragraph at lines 36189--36189 []\T1/cmtt/m/n/10 AstYamlChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astYamlChan ( 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 36189--36189 \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 this function will be used by the YamlChan to obtain lines of i nput text. On Overfull \hbox (21.36719pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 []\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 36189--36189 \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 this function will be used by the YamlChan to deliver lines of output text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 []\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 593 undefined on input line 361 89. Overfull \hbox (10.86975pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ya mlChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 [] \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [593] Overfull \hbox (8.24539pt too wide) in paragraph at lines 36189--36189 [][]\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 36189--36189 \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 36189--36189 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [594] LaTeX Warning: Hyper reference `ZoomMap' on page 595 undefined on input line 36 270. LaTeX Warning: Hyper reference `Mapping' on page 595 undefined on input line 36 270. Overfull \hbox (26.09103pt too wide) in paragraph at lines 36270--36270 \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 36270--36270 \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 595 undefined on input line 36270 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 36270--36270 \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 36270--36270 \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 36270--36270 \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 595 undefined on input line 362 70. Overfull \hbox (10.86975pt too wide) in paragraph at lines 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 [] \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 36270--36270 \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 36270--36270 \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 595 undefined on input line 362 70. Overfull \hbox (5.62103pt too wide) in paragraph at lines 36270--36270 [][]\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 36270--36270 []\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 36270--36270 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [595] [596] [597] LaTeX Warning: Hyper reference `astGrid' on page 598 undefined on input line 36 314. LaTeX Warning: Hyper reference `Plot' on page 598 undefined on input line 36314 . [598] LaTeX Warning: Hyper reference `Region' on page 599 undefined on input line 363 75. LaTeX Warning: Hyper reference `System' on page 599 undefined on input line 363 75. LaTeX Warning: Hyper reference `Mapping' on page 599 undefined on input line 36 375. LaTeX Warning: Hyper reference `Epoch' on page 599 undefined on input line 3637 5. [599] LaTeX Warning: Hyper reference `SkyFrame' on page 600 undefined on input line 3 6408. LaTeX Warning: Hyper reference `astFindFrame' on page 600 undefined on input li ne 36408. LaTeX Warning: Hyper reference `astConvert' on page 600 undefined on input line 36408. LaTeX Warning: Hyper reference `SkyRefIs' on page 600 undefined on input line 3 6408. LaTeX Warning: Hyper reference `UnitMap' on page 600 undefined on input line 36 408. LaTeX Warning: Hyper reference `AlignSystem' on page 600 undefined on input lin e 36408. [600] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 601 undefined on input li ne 36476. LaTeX Warning: Hyper reference `astFindFrame' on page 601 undefined on input li ne 36476. LaTeX Warning: Hyper reference `astConvert' on page 601 undefined on input line 36476. LaTeX Warning: Hyper reference `SideBand' on page 601 undefined on input line 3 6476. LaTeX Warning: Hyper reference `Mapping' on page 601 undefined on input line 36 476. LaTeX Warning: Hyper reference `SpecFrame' on page 601 undefined on input line 36476. LaTeX Warning: Hyper reference `System' on page 601 undefined on input line 364 76. LaTeX Warning: Hyper reference `StdOfRest' on page 601 undefined on input line 36476. [601] LaTeX Warning: Hyper reference `SpecFrame' on page 602 undefined on input line 36506. LaTeX Warning: Hyper reference `astFindFrame' on page 602 undefined on input li ne 36506. LaTeX Warning: Hyper reference `astConvert' on page 602 undefined on input line 36506. [602] LaTeX Warning: Hyper reference `SpecFrame' on page 603 undefined on input line 36561. LaTeX Warning: Hyper reference `astFindFrame' on page 603 undefined on input li ne 36561. LaTeX Warning: Hyper reference `astConvert' on page 603 undefined on input line 36561. LaTeX Warning: Hyper reference `StdOfRest' on page 603 undefined on input line 36561. LaTeX Warning: Hyper reference `Mapping' on page 603 undefined on input line 36 561. LaTeX Warning: Hyper reference `AlignSystem' on page 603 undefined on input lin e 36561. LaTeX Warning: Hyper reference `Epoch' on page 603 undefined on input line 3656 1. LaTeX Warning: Hyper reference `ObsLat' on page 603 undefined on input line 365 61. LaTeX Warning: Hyper reference `ObsLon' on page 603 undefined on input line 365 61. LaTeX Warning: Hyper reference `ObsAlt' on page 603 undefined on input line 365 61. LaTeX Warning: Hyper reference `RefDec' on page 603 undefined on input line 365 61. LaTeX Warning: Hyper reference `RefRA' on page 603 undefined on input line 3656 1. [603] LaTeX Warning: Hyper reference `Frame' on page 604 undefined on input line 3662 6. LaTeX Warning: Hyper reference `astFindFrame' on page 604 undefined on input li ne 36626. LaTeX Warning: Hyper reference `astConvert' on page 604 undefined on input line 36626. LaTeX Warning: Hyper reference `System' on page 604 undefined on input line 366 26. LaTeX Warning: Hyper reference `Mapping' on page 604 undefined on input line 36 626. LaTeX Warning: Hyper reference `CmpFrame' on page 604 undefined on input line 3 6626. LaTeX Warning: Hyper reference `FrameSet' on page 604 undefined on input line 3 6626. LaTeX Warning: Hyper reference `Current' on page 604 undefined on input line 36 626. LaTeX Warning: Hyper reference `SkyFrame' on page 604 undefined on input line 3 6626. LaTeX Warning: Hyper reference `SpecFrame' on page 604 undefined on input line 36626. LaTeX Warning: Hyper reference `TimeFrame' on page 604 undefined on input line 36626. [604] LaTeX Warning: Hyper reference `TimeFrame' on page 605 undefined on input line 36677. LaTeX Warning: Hyper reference `astFindFrame' on page 605 undefined on input li ne 36677. LaTeX Warning: Hyper reference `astConvert' on page 605 undefined on input line 36677. LaTeX Warning: Hyper reference `TimeScale' on page 605 undefined on input line 36677. LaTeX Warning: Hyper reference `Mapping' on page 605 undefined on input line 36 677. LaTeX Warning: Hyper reference `AlignSystem' on page 605 undefined on input lin e 36677. [605] LaTeX Warning: Hyper reference `Frame' on page 606 undefined on input line 3670 0. LaTeX Warning: Hyper reference `Variant' on page 606 undefined on input line 36 700. LaTeX Warning: Hyper reference `Domain' on page 606 undefined on input line 367 00. LaTeX Warning: Hyper reference `FrameSet' on page 606 undefined on input line 3 6700. [606] LaTeX Warning: Hyper reference `Warnings' on page 607 undefined on input line 3 6834. LaTeX Warning: Hyper reference `FitsChan' on page 607 undefined on input line 3 6834. LaTeX Warning: Hyper reference `FrameSet' on page 607 undefined on input line 3 6834. LaTeX Warning: Hyper reference `PVi_m' on page 607 undefined on input line 3683 4. LaTeX Warning: Hyper reference `astRead' on page 607 undefined on input line 36 834. [607] [608] LaTeX Warning: Hyper reference `astWrite' on page 609 undefined on input line 3 6892. LaTeX Warning: Hyper reference `FrameSet' on page 609 undefined on input line 3 6892. LaTeX Warning: Hyper reference `Frame' on page 609 undefined on input line 3689 2. LaTeX Warning: Hyper reference `Base' on page 609 undefined on input line 36892 . LaTeX Warning: Hyper reference `Current' on page 609 undefined on input line 36 892. LaTeX Warning: Hyper reference `Ident' on page 609 undefined on input line 3689 2. LaTeX Warning: Hyper reference `FitsChan' on page 609 undefined on input line 3 6892. LaTeX Warning: Hyper reference `Encoding' on page 609 undefined on input line 3 6892. [609] LaTeX Warning: Hyper reference `astFormat' on page 610 undefined on input line 36941. LaTeX Warning: Hyper reference `SkyFrame' on page 610 undefined on input line 3 6941. LaTeX Warning: Hyper reference `System' on page 610 undefined on input line 369 41. LaTeX Warning: Hyper reference `Format(axis)' on page 610 undefined on input li ne 36941. LaTeX Warning: Hyper reference `Unit(axis)' on page 610 undefined on input line 36941. [610] LaTeX Warning: Hyper reference `Frame' on page 611 undefined on input line 3697 9. LaTeX Warning: Hyper reference `FrameSet' on page 611 undefined on input line 3 6979. LaTeX Warning: Hyper reference `Domain' on page 611 undefined on input line 369 79. LaTeX Warning: Hyper reference `Invert' on page 611 undefined on input line 369 79. LaTeX Warning: Hyper reference `astInvert' on page 611 undefined on input line 36979. LaTeX Warning: Hyper reference `Current' on page 611 undefined on input line 36 979. [611] LaTeX Warning: Hyper reference `astGrid' on page 612 undefined on input line 37 010. LaTeX Warning: Hyper reference `Plot' on page 612 undefined on input line 37010 . LaTeX Warning: Hyper reference `astBorder' on page 612 undefined on input line 37010. LaTeX Warning: Hyper reference `Labelling' on page 612 undefined on input line 37010. [612] LaTeX Warning: Hyper reference `astGrid' on page 613 undefined on input line 37 047. LaTeX Warning: Hyper reference `Frame' on page 613 undefined on input line 3704 7. LaTeX Warning: Hyper reference `SkyFrame' on page 613 undefined on input line 3 7047. [613] LaTeX Warning: Hyper reference `Region' on page 614 undefined on input line 370 68. [614] LaTeX Warning: Hyper reference `FitsChan' on page 615 undefined on input line 3 7117. LaTeX Warning: Hyper reference `FrameSet' on page 615 undefined on input line 3 7117. LaTeX Warning: Hyper reference `Encoding' on page 615 undefined on input line 3 7117. [615] LaTeX Warning: Hyper reference `FrameSet' on page 616 undefined on input line 3 7154. LaTeX Warning: Hyper reference `Mapping' on page 616 undefined on input line 37 154. LaTeX Warning: Hyper reference `FitsChan' on page 616 undefined on input line 3 7154. [616] LaTeX Warning: Hyper reference `FitsChan' on page 617 undefined on input line 3 7191. LaTeX Warning: Hyper reference `astDelFits' on page 617 undefined on input line 37191. LaTeX Warning: Hyper reference `astFindFits' on page 617 undefined on input lin e 37191. LaTeX Warning: Hyper reference `astPutFits' on page 617 undefined on input line 37191. LaTeX Warning: Hyper reference `astClear' on page 617 undefined on input line 3 7191. LaTeX Warning: Hyper reference `Ncard' on page 617 undefined on input line 3719 1. [617] LaTeX Warning: Hyper reference `FitsChan' on page 618 undefined on input line 3 7211. [618] LaTeX Warning: Hyper reference `FitsChan' on page 619 undefined on input line 3 7231. [619] LaTeX Warning: Hyper reference `FitsChan' on page 620 undefined on input line 3 7254. Overfull \hbox (37.49187pt too wide) in paragraph at lines 37254--37254 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [620] LaTeX Warning: Hyper reference `Object' on page 621 undefined on input line 372 74. [621] LaTeX Warning: Hyper reference `FitsChan' on page 622 undefined on input line 3 7307. LaTeX Warning: Hyper reference `astRead' on page 622 undefined on input line 37 307. LaTeX Warning: Hyper reference `Object' on page 622 undefined on input line 373 07. [622] LaTeX Warning: Hyper reference `Plot' on page 623 undefined on input line 37340 . LaTeX Warning: Hyper reference `astClip' on page 623 undefined on input line 37 340. [623] LaTeX Warning: Hyper reference `Plot' on page 624 undefined on input line 37375 . LaTeX Warning: Hyper reference `astClip' on page 624 undefined on input line 37 375. LaTeX Warning: Hyper reference `Frame' on page 624 undefined on input line 3737 5. [624] LaTeX Warning: Hyper reference `Region' on page 625 undefined on input line 374 28. LaTeX Warning: Hyper reference `PointList' on page 625 undefined on input line 37428. LaTeX Warning: Hyper reference `CmpRegion' on page 625 undefined on input line 37428. LaTeX Warning: Hyper reference `Stc' on page 625 undefined on input line 37428. LaTeX Warning: Hyper reference `Moc' on page 625 undefined on input line 37428. [625] LaTeX Warning: Hyper reference `Plot' on page 626 undefined on input line 37473 . [626] LaTeX Warning: Hyper reference `Table' on page 627 undefined on input line 3750 8. [627] LaTeX Warning: Hyper reference `Table' on page 628 undefined on input line 3753 1. [628] LaTeX Warning: Hyper reference `Table' on page 629 undefined on input line 3755 5. [629] LaTeX Warning: Hyper reference `Table' on page 630 undefined on input line 3759 1. LaTeX Warning: Hyper reference `astAddColumn' on page 630 undefined on input li ne 37591. LaTeX Warning: Hyper reference `Object' on page 630 undefined on input line 375 91. LaTeX Warning: Hyper reference `astMapPutU' on page 630 undefined on input line 37591. [630] LaTeX Warning: Hyper reference `Channel' on page 631 undefined on input line 37 632. LaTeX Warning: Hyper reference `FitsChan' on page 631 undefined on input line 3 7632. LaTeX Warning: Hyper reference `XmlChan' on page 631 undefined on input line 37 632. LaTeX Warning: Hyper reference `YamlChan' on page 631 undefined on input line 3 7632. [631] LaTeX Warning: Hyper reference `Frame' on page 632 undefined on input line 3767 0. LaTeX Warning: Hyper reference `FrameSet' on page 632 undefined on input line 3 7670. LaTeX Warning: Hyper reference `Nframe' on page 632 undefined on input line 376 70. LaTeX Warning: Hyper reference `Domain' on page 632 undefined on input line 376 70. LaTeX Warning: Hyper reference `Invert' on page 632 undefined on input line 376 70. LaTeX Warning: Hyper reference `astInvert' on page 632 undefined on input line 37670. LaTeX Warning: Hyper reference `Base' on page 632 undefined on input line 37670 . [632] LaTeX Warning: Hyper reference `IF' on page 633 undefined on input line 37724. LaTeX Warning: Hyper reference `SpecFrame' on page 633 undefined on input line 37724. LaTeX Warning: Hyper reference `System' on page 633 undefined on input line 377 24. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 633 undefined on input li ne 37724. LaTeX Warning: Hyper reference `StdOfRest' on page 633 undefined on input line 37724. LaTeX Warning: Hyper reference `ObsLon' on page 633 undefined on input line 377 24. LaTeX Warning: Hyper reference `ObsLat' on page 633 undefined on input line 377 24. LaTeX Warning: Hyper reference `ObsAlt' on page 633 undefined on input line 377 24. LaTeX Warning: Hyper reference `Epoch' on page 633 undefined on input line 3772 4. LaTeX Warning: Hyper reference `RefRA' on page 633 undefined on input line 3772 4. LaTeX Warning: Hyper reference `RefDec' on page 633 undefined on input line 377 24. LaTeX Warning: Hyper reference `RestFreq' on page 633 undefined on input line 3 7724. [633] LaTeX Warning: Hyper reference `FrameSet' on page 634 undefined on input line 3 7751. LaTeX Warning: Hyper reference `FitsChan' on page 634 undefined on input line 3 7751. LaTeX Warning: Hyper reference `Encoding' on page 634 undefined on input line 3 7751. [634] LaTeX Warning: Hyper reference `Frame' on page 635 undefined on input line 3780 4. LaTeX Warning: Hyper reference `astFormat' on page 635 undefined on input line 37804. LaTeX Warning: Hyper reference `FrameSet' on page 635 undefined on input line 3 7804. LaTeX Warning: Hyper reference `Current' on page 635 undefined on input line 37 804. LaTeX Warning: Hyper reference `Plot' on page 635 undefined on input line 37804 . LaTeX Warning: Hyper reference `TimeFrame' on page 635 undefined on input line 37804. [635] LaTeX Warning: Hyper reference `Frame' on page 636 undefined on input line 3786 9. LaTeX Warning: Hyper reference `SkyFrame' on page 636 undefined on input line 3 7869. LaTeX Warning: Hyper reference `FrameSet' on page 636 undefined on input line 3 7869. LaTeX Warning: Hyper reference `Current' on page 636 undefined on input line 37 869. LaTeX Warning: Hyper reference `Plot' on page 636 undefined on input line 37869 . [636] LaTeX Warning: Hyper reference `PcdMap' on page 637 undefined on input line 379 08. LaTeX Warning: Hyper reference `astInvert' on page 637 undefined on input line 37908. LaTeX Warning: Hyper reference `CmpMap' on page 637 undefined on input line 379 08. LaTeX Warning: Hyper reference `FrameSet' on page 637 undefined on input line 3 7908. LaTeX Warning: Hyper reference `astClone' on page 637 undefined on input line 3 7908. [637] LaTeX Warning: Hyper reference `Frame' on page 638 undefined on input line 3799 6. LaTeX Warning: Hyper reference `astFindFrame' on page 638 undefined on input li ne 37996. LaTeX Warning: Hyper reference `SkyFrame' on page 638 undefined on input line 3 7996. LaTeX Warning: Hyper reference `CmpFrame' on page 638 undefined on input line 3 7996. LaTeX Warning: Hyper reference `FrameSet' on page 638 undefined on input line 3 7996. LaTeX Warning: Hyper reference `Current' on page 638 undefined on input line 37 996. LaTeX Warning: Hyper reference `SpecFrame' on page 638 undefined on input line 37996. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 638 undefined on input li ne 37996. LaTeX Warning: Hyper reference `FluxFrame' on page 638 undefined on input line 37996. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 638 undefined on input l ine 37996. LaTeX Warning: Hyper reference `TimeFrame' on page 638 undefined on input line 37996. [638] LaTeX Warning: Hyper reference `astGrid' on page 639 undefined on input line 38 049. LaTeX Warning: Hyper reference `Plot' on page 639 undefined on input line 38049 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 639 undefined on input l ine 38049. LaTeX Warning: Hyper reference `Axis' on page 639 undefined on input line 38049 . LaTeX Warning: Hyper reference `Grid' on page 639 undefined on input line 38049 . LaTeX Warning: Hyper reference `Labelling' on page 639 undefined on input line 38049. [639] LaTeX Warning: Hyper reference `astGrid' on page 640 undefined on input line 38 091. LaTeX Warning: Hyper reference `Plot' on page 640 undefined on input line 38091 . LaTeX Warning: Hyper reference `Plot3D' on page 640 undefined on input line 380 91. LaTeX Warning: Hyper reference `Title' on page 640 undefined on input line 3809 1. LaTeX Warning: Hyper reference `TitleGap' on page 640 undefined on input line 3 8091. [640] LaTeX Warning: Hyper reference `Frame' on page 641 undefined on input line 3811 8. LaTeX Warning: Hyper reference `Epoch' on page 641 undefined on input line 3811 8. [641] LaTeX Warning: Hyper reference `SkyFrame' on page 642 undefined on input line 3 8154. LaTeX Warning: Hyper reference `Epoch' on page 642 undefined on input line 3815 4. LaTeX Warning: Hyper reference `Frame' on page 642 undefined on input line 3815 4. [642] LaTeX Warning: Hyper reference `astGrid' on page 643 undefined on input line 38 206. LaTeX Warning: Hyper reference `Plot' on page 643 undefined on input line 38206 . LaTeX Warning: Hyper reference `Labelling' on page 643 undefined on input line 38206. LaTeX Warning: Hyper reference `Plot3D' on page 643 undefined on input line 382 06. LaTeX Warning: Hyper reference `RootCorner' on page 643 undefined on input line 38206. [643] LaTeX Warning: Hyper reference `FitsChan' on page 644 undefined on input line 3 8829. LaTeX Warning: Hyper reference `astWrite' on page 644 undefined on input line 3 8829. LaTeX Warning: Hyper reference `astRead' on page 644 undefined on input line 38 829. LaTeX Warning: Hyper reference `Object' on page 644 undefined on input line 388 29. LaTeX Warning: Hyper reference `Channel' on page 644 undefined on input line 38 829. [644] [645] LaTeX Warning: Hyper reference `FrameSet' on page 646 undefined on input line 3 8829. LaTeX Warning: Hyper reference `Mapping' on page 646 undefined on input line 38 829. LaTeX Warning: Hyper reference `DssMap' on page 646 undefined on input line 388 29. LaTeX Warning: Hyper reference `WcsMap' on page 646 undefined on input line 388 29. LaTeX Warning: Hyper reference `Card' on page 646 undefined on input line 38829 . LaTeX Warning: Hyper reference `Frame' on page 646 undefined on input line 3882 9. LaTeX Warning: Hyper reference `SkyFrame' on page 646 undefined on input line 3 8829. [646] LaTeX Warning: Hyper reference `CDMatrix' on page 647 undefined on input line 3 8829. LaTeX Warning: Hyper reference `PVi_m' on page 647 undefined on input line 3882 9. LaTeX Warning: Hyper reference `SkyRefIs' on page 647 undefined on input line 3 8829. LaTeX Warning: Hyper reference `System' on page 647 undefined on input line 388 29. [647] [648] LaTeX Warning: Hyper reference `SpecFrame' on page 649 undefined on input line 38829. LaTeX Warning: Hyper reference `ObsLat' on page 649 undefined on input line 388 29. LaTeX Warning: Hyper reference `ObsLon' on page 649 undefined on input line 388 29. LaTeX Warning: Hyper reference `ObsAlt' on page 649 undefined on input line 388 29. [649] LaTeX Warning: Hyper reference `SourceVel' on page 650 undefined on input line 38829. LaTeX Warning: Hyper reference `SourceVRF' on page 650 undefined on input line 38829. LaTeX Warning: Hyper reference `Class' on page 650 undefined on input line 3882 9. LaTeX Warning: Hyper reference `ID' on page 650 undefined on input line 38829. [650] LaTeX Warning: Hyper reference `Frame' on page 651 undefined on input line 3897 7. LaTeX Warning: Hyper reference `System' on page 651 undefined on input line 389 77. LaTeX Warning: Hyper reference `CmpFrame' on page 651 undefined on input line 3 8977. LaTeX Warning: Hyper reference `FrameSet' on page 651 undefined on input line 3 8977. LaTeX Warning: Hyper reference `Current' on page 651 undefined on input line 38 977. LaTeX Warning: Hyper reference `SkyFrame' on page 651 undefined on input line 3 8977. LaTeX Warning: Hyper reference `Equinox' on page 651 undefined on input line 38 977. LaTeX Warning: Hyper reference `TimeFrame' on page 651 undefined on input line 38977. LaTeX Warning: Hyper reference `TimeOrigin' on page 651 undefined on input line 38977. [651] [652] LaTeX Warning: Hyper reference `SkyFrame' on page 653 undefined on input line 3 9044. LaTeX Warning: Hyper reference `Epoch' on page 653 undefined on input line 3904 4. LaTeX Warning: Hyper reference `System' on page 653 undefined on input line 390 44. [653] LaTeX Warning: Hyper reference `astGrid' on page 654 undefined on input line 39 151. LaTeX Warning: Hyper reference `Plot' on page 654 undefined on input line 39151 . LaTeX Warning: Hyper reference `astText' on page 654 undefined on input line 39 151. LaTeX Warning: Hyper reference `Plot3D' on page 654 undefined on input line 391 51. LaTeX Warning: Hyper reference `astEscapes' on page 654 undefined on input line 39151. [654] [655] LaTeX Warning: Hyper reference `Region' on page 656 undefined on input line 391 94. LaTeX Warning: Hyper reference `CmpRegion' on page 656 undefined on input line 39194. LaTeX Warning: Hyper reference `Prism' on page 656 undefined on input line 3919 4. LaTeX Warning: Hyper reference `Stc' on page 656 undefined on input line 39194. [656] LaTeX Warning: Hyper reference `astWrite' on page 657 undefined on input line 3 9237. LaTeX Warning: Hyper reference `Frame' on page 657 undefined on input line 3923 7. LaTeX Warning: Hyper reference `FrameSet' on page 657 undefined on input line 3 9237. LaTeX Warning: Hyper reference `FitsChan' on page 657 undefined on input line 3 9237. [657] LaTeX Warning: Hyper reference `FitsChan' on page 658 undefined on input line 3 9279. LaTeX Warning: Hyper reference `astFindFits' on page 658 undefined on input lin e 39279. [658] LaTeX Warning: Hyper reference `FitsChan' on page 659 undefined on input line 3 9313. LaTeX Warning: Hyper reference `FitsDigits' on page 659 undefined on input line 39313. [659] LaTeX Warning: Hyper reference `FrameSet' on page 660 undefined on input line 3 9342. LaTeX Warning: Hyper reference `FitsChan' on page 660 undefined on input line 3 9342. LaTeX Warning: Hyper reference `Mapping' on page 660 undefined on input line 39 342. [660] LaTeX Warning: Hyper reference `Plot' on page 661 undefined on input line 39386 . [661] LaTeX Warning: Hyper reference `FrameSet' on page 662 undefined on input line 3 9418. LaTeX Warning: Hyper reference `TabOK' on page 662 undefined on input line 3941 8. LaTeX Warning: Hyper reference `astWrite' on page 662 undefined on input line 3 9418. LaTeX Warning: Hyper reference `FitsChan' on page 662 undefined on input line 3 9418. [662] LaTeX Warning: Hyper reference `Frame' on page 663 undefined on input line 3961 5. LaTeX Warning: Hyper reference `astFormat' on page 663 undefined on input line 39615. LaTeX Warning: Hyper reference `astSet' on page 663 undefined on input line 396 15. LaTeX Warning: Hyper reference `SkyFrame' on page 663 undefined on input line 3 9615. LaTeX Warning: Hyper reference `FrameSet' on page 663 undefined on input line 3 9615. LaTeX Warning: Hyper reference `Current' on page 663 undefined on input line 39 615. LaTeX Warning: Hyper reference `TimeFrame' on page 663 undefined on input line 39615. [663] LaTeX Warning: Hyper reference `Plot' on page 664 undefined on input line 39615 . LaTeX Warning: Hyper reference `TimeOrigin' on page 664 undefined on input line 39615. [664] [665] LaTeX Warning: Hyper reference `Channel' on page 666 undefined on input line 39 672. LaTeX Warning: Hyper reference `Object' on page 666 undefined on input line 396 72. LaTeX Warning: Hyper reference `FitsChan' on page 666 undefined on input line 3 9672. LaTeX Warning: Hyper reference `StcsChan' on page 666 undefined on input line 3 9672. LaTeX Warning: Hyper reference `XmlChan' on page 666 undefined on input line 39 672. LaTeX Warning: Hyper reference `YamlChan' on page 666 undefined on input line 3 9672. [666] LaTeX Warning: Hyper reference `astGrid' on page 667 undefined on input line 39 724. LaTeX Warning: Hyper reference `Plot' on page 667 undefined on input line 39724 . LaTeX Warning: Hyper reference `Format(axis)' on page 667 undefined on input li ne 39724. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 667 undefined on i nput line 39724. [667] LaTeX Warning: Hyper reference `Plot' on page 668 undefined on input line 39767 . LaTeX Warning: Hyper reference `ast_link' on page 668 undefined on input line 3 9767. LaTeX Warning: Hyper reference `astGrfSet' on page 668 undefined on input line 39767. LaTeX Warning: Hyper reference `Plot3D' on page 668 undefined on input line 397 67. LaTeX Warning: Hyper reference `Channel' on page 668 undefined on input line 39 767. LaTeX Warning: Hyper reference `astRead' on page 668 undefined on input line 39 767. [668] LaTeX Warning: Hyper reference `astGrid' on page 669 undefined on input line 39 803. LaTeX Warning: Hyper reference `Plot' on page 669 undefined on input line 39803 . LaTeX Warning: Hyper reference `Gap(axis)' on page 669 undefined on input line 39803. [669] LaTeX Warning: Hyper reference `GrismMap' on page 670 undefined on input line 3 9830. LaTeX Warning: Hyper reference `CmpMap' on page 670 undefined on input line 398 30. LaTeX Warning: Hyper reference `FrameSet' on page 670 undefined on input line 3 9830. LaTeX Warning: Hyper reference `astClone' on page 670 undefined on input line 3 9830. [670] LaTeX Warning: Hyper reference `GrismMap' on page 671 undefined on input line 3 9859. LaTeX Warning: Hyper reference `CmpMap' on page 671 undefined on input line 398 59. LaTeX Warning: Hyper reference `FrameSet' on page 671 undefined on input line 3 9859. LaTeX Warning: Hyper reference `astClone' on page 671 undefined on input line 3 9859. [671] LaTeX Warning: Hyper reference `GrismWaveR' on page 672 undefined on input line 39888. LaTeX Warning: Hyper reference `GrismNRP' on page 672 undefined on input line 3 9888. LaTeX Warning: Hyper reference `GrismMap' on page 672 undefined on input line 3 9888. LaTeX Warning: Hyper reference `CmpMap' on page 672 undefined on input line 398 88. LaTeX Warning: Hyper reference `FrameSet' on page 672 undefined on input line 3 9888. LaTeX Warning: Hyper reference `astClone' on page 672 undefined on input line 3 9888. [672] LaTeX Warning: Hyper reference `GrismMap' on page 673 undefined on input line 3 9915. LaTeX Warning: Hyper reference `CmpMap' on page 673 undefined on input line 399 15. LaTeX Warning: Hyper reference `FrameSet' on page 673 undefined on input line 3 9915. LaTeX Warning: Hyper reference `astClone' on page 673 undefined on input line 3 9915. [673] LaTeX Warning: Hyper reference `GrismWaveR' on page 674 undefined on input line 39943. LaTeX Warning: Hyper reference `GrismMap' on page 674 undefined on input line 3 9943. LaTeX Warning: Hyper reference `CmpMap' on page 674 undefined on input line 399 43. LaTeX Warning: Hyper reference `FrameSet' on page 674 undefined on input line 3 9943. LaTeX Warning: Hyper reference `astClone' on page 674 undefined on input line 3 9943. [674] LaTeX Warning: Hyper reference `GrismWaveR' on page 675 undefined on input line 39974. LaTeX Warning: Hyper reference `GrismG' on page 675 undefined on input line 399 74. LaTeX Warning: Hyper reference `GrismMap' on page 675 undefined on input line 3 9974. LaTeX Warning: Hyper reference `CmpMap' on page 675 undefined on input line 399 74. LaTeX Warning: Hyper reference `FrameSet' on page 675 undefined on input line 3 9974. LaTeX Warning: Hyper reference `astClone' on page 675 undefined on input line 3 9974. [675] LaTeX Warning: Hyper reference `GrismWaveR' on page 676 undefined on input line 40004. LaTeX Warning: Hyper reference `GrismMap' on page 676 undefined on input line 4 0004. LaTeX Warning: Hyper reference `CmpMap' on page 676 undefined on input line 400 04. LaTeX Warning: Hyper reference `FrameSet' on page 676 undefined on input line 4 0004. LaTeX Warning: Hyper reference `astClone' on page 676 undefined on input line 4 0004. [676] LaTeX Warning: Hyper reference `GrismNRP' on page 677 undefined on input line 4 0032. LaTeX Warning: Hyper reference `GrismG' on page 677 undefined on input line 400 32. LaTeX Warning: Hyper reference `GrismMap' on page 677 undefined on input line 4 0032. LaTeX Warning: Hyper reference `CmpMap' on page 677 undefined on input line 400 32. LaTeX Warning: Hyper reference `FrameSet' on page 677 undefined on input line 4 0032. LaTeX Warning: Hyper reference `astClone' on page 677 undefined on input line 4 0032. [677] LaTeX Warning: Hyper reference `Object' on page 678 undefined on input line 400 75. LaTeX Warning: Hyper reference `astWrite' on page 678 undefined on input line 4 0075. LaTeX Warning: Hyper reference `astRead' on page 678 undefined on input line 40 075. LaTeX Warning: Hyper reference `astShow' on page 678 undefined on input line 40 075. [678] LaTeX Warning: Hyper reference `DSBCentre' on page 679 undefined on input line 40116. LaTeX Warning: Hyper reference `SideBand' on page 679 undefined on input line 4 0116. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 679 undefined on input li ne 40116. [679] LaTeX Warning: Hyper reference `ID' on page 680 undefined on input line 40138. LaTeX Warning: Hyper reference `Object' on page 680 undefined on input line 401 38. [680] LaTeX Warning: Hyper reference `RestFreq' on page 681 undefined on input line 4 0169. LaTeX Warning: Hyper reference `SourceVel' on page 681 undefined on input line 40169. LaTeX Warning: Hyper reference `SourceVRF' on page 681 undefined on input line 40169. LaTeX Warning: Hyper reference `DSBCentre' on page 681 undefined on input line 40169. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 681 undefined on input li ne 40169. [681] LaTeX Warning: Hyper reference `astWrite' on page 682 undefined on input line 4 0246. LaTeX Warning: Hyper reference `Channel' on page 682 undefined on input line 40 246. LaTeX Warning: Hyper reference `FitsChan' on page 682 undefined on input line 4 0246. LaTeX Warning: Hyper reference `StcsChan' on page 682 undefined on input line 4 0246. LaTeX Warning: Hyper reference `StcsLength' on page 682 undefined on input line 40246. LaTeX Warning: Hyper reference `XmlChan' on page 682 undefined on input line 40 246. LaTeX Warning: Hyper reference `YamlChan' on page 682 undefined on input line 4 0246. [682] LaTeX Warning: Hyper reference `Frame' on page 683 undefined on input line 4028 2. LaTeX Warning: Hyper reference `SkyFrame' on page 683 undefined on input line 4 0282. [683] LaTeX Warning: Hyper reference `IntraMap' on page 684 undefined on input line 4 0324. LaTeX Warning: Hyper reference `UnitMap' on page 684 undefined on input line 40 324. LaTeX Warning: Hyper reference `astSimplify' on page 684 undefined on input lin e 40324. [684] LaTeX Warning: Hyper reference `Mapping' on page 685 undefined on input line 40 373. LaTeX Warning: Hyper reference `Nin' on page 685 undefined on input line 40373. LaTeX Warning: Hyper reference `Nout' on page 685 undefined on input line 40373 . LaTeX Warning: Hyper reference `TranForward' on page 685 undefined on input lin e 40373. LaTeX Warning: Hyper reference `TranInverse' on page 685 undefined on input lin e 40373. LaTeX Warning: Hyper reference `astInvert' on page 685 undefined on input line 40373. LaTeX Warning: Hyper reference `UnitMap' on page 685 undefined on input line 40 373. LaTeX Warning: Hyper reference `FrameSet' on page 685 undefined on input line 4 0373. LaTeX Warning: Hyper reference `Base' on page 685 undefined on input line 40373 . LaTeX Warning: Hyper reference `Current' on page 685 undefined on input line 40 373. LaTeX Warning: Hyper reference `Naxes' on page 685 undefined on input line 4037 3. LaTeX Warning: Hyper reference `Frame' on page 685 undefined on input line 4037 3. [685] LaTeX Warning: Hyper reference `Plot' on page 686 undefined on input line 40403 . LaTeX Warning: Hyper reference `astBoundingBox' on page 686 undefined on input line 40403. [686] LaTeX Warning: Hyper reference `SkyFrame' on page 687 undefined on input line 4 0433. [687] LaTeX Warning: Hyper reference `Mapping' on page 688 undefined on input line 40 480. LaTeX Warning: Hyper reference `MathMap' on page 688 undefined on input line 40 480. LaTeX Warning: Hyper reference `astLinearApprox' on page 688 undefined on input line 40480. LaTeX Warning: Hyper reference `CmpMap' on page 688 undefined on input line 404 80. LaTeX Warning: Hyper reference `ZoomMap' on page 688 undefined on input line 40 480. LaTeX Warning: Hyper reference `ShiftMap' on page 688 undefined on input line 4 0480. LaTeX Warning: Hyper reference `Frame' on page 688 undefined on input line 4048 0. LaTeX Warning: Hyper reference `UnitMap' on page 688 undefined on input line 40 480. LaTeX Warning: Hyper reference `FrameSet' on page 688 undefined on input line 4 0480. [688] LaTeX Warning: Hyper reference `SkyFrame' on page 689 undefined on input line 4 0510. [689] LaTeX Warning: Hyper reference `Mapping' on page 690 undefined on input line 40 548. LaTeX Warning: Hyper reference `astSimplify' on page 690 undefined on input lin e 40548. LaTeX Warning: Hyper reference `Frame' on page 690 undefined on input line 4054 8. [690] LaTeX Warning: Hyper reference `PolyMap' on page 691 undefined on input line 40 628. LaTeX Warning: Hyper reference `NiterInverse' on page 691 undefined on input li ne 40628. LaTeX Warning: Hyper reference `TolInverse' on page 691 undefined on input line 40628. LaTeX Warning: Hyper reference `ChebyMap' on page 691 undefined on input line 4 0628. LaTeX Warning: Hyper reference `Nin' on page 691 undefined on input line 40628. LaTeX Warning: Hyper reference `Nout' on page 691 undefined on input line 40628 . [691] LaTeX Warning: Hyper reference `FrameSet' on page 692 undefined on input line 4 0663. LaTeX Warning: Hyper reference `FitsChan' on page 692 undefined on input line 4 0663. LaTeX Warning: Hyper reference `astRead' on page 692 undefined on input line 40 663. LaTeX Warning: Hyper reference `Domain' on page 692 undefined on input line 406 63. [692] LaTeX Warning: Hyper reference `KeyMap' on page 693 undefined on input line 406 97. LaTeX Warning: Hyper reference `Table' on page 693 undefined on input line 4069 7. [693] LaTeX Warning: Hyper reference `KeyMap' on page 694 undefined on input line 407 34. [694] LaTeX Warning: Hyper reference `TimeFrame' on page 695 undefined on input line 40756. [695] LaTeX Warning: Hyper reference `Frame' on page 696 undefined on input line 4081 3. LaTeX Warning: Hyper reference `Axis' on page 696 undefined on input line 40813 . LaTeX Warning: Hyper reference `SkyFrame' on page 696 undefined on input line 4 0813. LaTeX Warning: Hyper reference `TimeFrame' on page 696 undefined on input line 40813. LaTeX Warning: Hyper reference `FrameSet' on page 696 undefined on input line 4 0813. LaTeX Warning: Hyper reference `Current' on page 696 undefined on input line 40 813. [696] LaTeX Warning: Hyper reference `astGrid' on page 697 undefined on input line 40 872. LaTeX Warning: Hyper reference `Plot' on page 697 undefined on input line 40872 . LaTeX Warning: Hyper reference `Labelling' on page 697 undefined on input line 40872. [697] LaTeX Warning: Hyper reference `astGrid' on page 698 undefined on input line 40 925. LaTeX Warning: Hyper reference `Plot' on page 698 undefined on input line 40925 . LaTeX Warning: Hyper reference `Frame' on page 698 undefined on input line 4092 5. LaTeX Warning: Hyper reference `SkyFrame' on page 698 undefined on input line 4 0925. LaTeX Warning: Hyper reference `Unit(axis)' on page 698 undefined on input line 40925. [698] LaTeX Warning: Hyper reference `astGrid' on page 699 undefined on input line 40 976. LaTeX Warning: Hyper reference `Plot' on page 699 undefined on input line 40976 . LaTeX Warning: Hyper reference `Labelling' on page 699 undefined on input line 40976. [699] LaTeX Warning: Hyper reference `astGrid' on page 700 undefined on input line 41 012. LaTeX Warning: Hyper reference `Plot' on page 700 undefined on input line 41012 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 700 undefined on input l ine 41012. [700] LaTeX Warning: Hyper reference `SkyFrame' on page 701 undefined on input line 4 1033. [701] LaTeX Warning: Hyper reference `PointList' on page 702 undefined on input line 41053. [702] LaTeX Warning: Hyper reference `astGrid' on page 703 undefined on input line 41 102. LaTeX Warning: Hyper reference `Plot' on page 703 undefined on input line 41102 . [703] LaTeX Warning: Hyper reference `astGrid' on page 704 undefined on input line 41 143. LaTeX Warning: Hyper reference `Escape' on page 704 undefined on input line 411 43. LaTeX Warning: Hyper reference `Plot' on page 704 undefined on input line 41143 . [704] LaTeX Warning: Hyper reference `Plot' on page 705 undefined on input line 41201 . LaTeX Warning: Hyper reference `Frame' on page 705 undefined on input line 4120 1. LaTeX Warning: Hyper reference `FrameSet' on page 705 undefined on input line 4 1201. [705] LaTeX Warning: Hyper reference `astGrid' on page 706 undefined on input line 41 260. LaTeX Warning: Hyper reference `Plot' on page 706 undefined on input line 41260 . [706] LaTeX Warning: Hyper reference `SkyFrame' on page 707 undefined on input line 4 1281. [707] LaTeX Warning: Hyper reference `LutMap' on page 708 undefined on input line 413 16. LaTeX Warning: Hyper reference `WinMap' on page 708 undefined on input line 413 16. LaTeX Warning: Hyper reference `Mapping' on page 708 undefined on input line 41 316. LaTeX Warning: Hyper reference `CmpMap' on page 708 undefined on input line 413 16. LaTeX Warning: Hyper reference `FrameSet' on page 708 undefined on input line 4 1316. LaTeX Warning: Hyper reference `astClone' on page 708 undefined on input line 4 1316. [708] LaTeX Warning: Hyper reference `LutMap' on page 709 undefined on input line 413 51. LaTeX Warning: Hyper reference `CmpMap' on page 709 undefined on input line 413 51. LaTeX Warning: Hyper reference `FrameSet' on page 709 undefined on input line 4 1351. LaTeX Warning: Hyper reference `astClone' on page 709 undefined on input line 4 1351. [709] LaTeX Warning: Hyper reference `astGrid' on page 710 undefined on input line 41 397. LaTeX Warning: Hyper reference `Plot' on page 710 undefined on input line 41397 . LaTeX Warning: Hyper reference `Grid' on page 710 undefined on input line 41397 . [710] LaTeX Warning: Hyper reference `KeyMap' on page 711 undefined on input line 414 35. [711] LaTeX Warning: Hyper reference `Frame' on page 712 undefined on input line 4147 2. LaTeX Warning: Hyper reference `astFindFrame' on page 712 undefined on input li ne 41472. LaTeX Warning: Hyper reference `FrameSet' on page 712 undefined on input line 4 1472. LaTeX Warning: Hyper reference `Current' on page 712 undefined on input line 41 472. [712] LaTeX Warning: Hyper reference `Frame' on page 713 undefined on input line 4153 6. LaTeX Warning: Hyper reference `astFindFrame' on page 713 undefined on input li ne 41536. LaTeX Warning: Hyper reference `Naxes' on page 713 undefined on input line 4153 6. LaTeX Warning: Hyper reference `CmpFrame' on page 713 undefined on input line 4 1536. LaTeX Warning: Hyper reference `MinAxes' on page 713 undefined on input line 41 536. LaTeX Warning: Hyper reference `FrameSet' on page 713 undefined on input line 4 1536. LaTeX Warning: Hyper reference `Current' on page 713 undefined on input line 41 536. LaTeX Warning: Hyper reference `MatchEnd' on page 713 undefined on input line 4 1536. [713] LaTeX Warning: Hyper reference `Moc' on page 714 undefined on input line 41598. LaTeX Warning: Hyper reference `astAddCell' on page 714 undefined on input line 41598. LaTeX Warning: Hyper reference `astAddRegion' on page 714 undefined on input li ne 41598. LaTeX Warning: Hyper reference `Region' on page 714 undefined on input line 415 98. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 714 undefined on inpu t line 41598. LaTeX Warning: Hyper reference `astAddPixelMask$<$X$>$' on page 714 undefined o n input line 41598. LaTeX Warning: Hyper reference `astAddMocData' on page 714 undefined on input l ine 41598. LaTeX Warning: Hyper reference `astAddMocString' on page 714 undefined on input line 41598. LaTeX Warning: Hyper reference `MaxRes' on page 714 undefined on input line 415 98. [714] LaTeX Warning: Hyper reference `MaxOrder' on page 715 undefined on input line 4 1624. LaTeX Warning: Hyper reference `Moc' on page 715 undefined on input line 41624. [715] LaTeX Warning: Hyper reference `Region' on page 716 undefined on input line 416 80. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 716 undefined on inpu t line 41680. LaTeX Warning: Hyper reference `CmpRegion' on page 716 undefined on input line 41680. LaTeX Warning: Hyper reference `Moc' on page 716 undefined on input line 41680. LaTeX Warning: Hyper reference `MaxOrder' on page 716 undefined on input line 4 1680. LaTeX Warning: Hyper reference `Stc' on page 716 undefined on input line 41680. [716] LaTeX Warning: Hyper reference `Frame' on page 717 undefined on input line 4174 2. LaTeX Warning: Hyper reference `astFindFrame' on page 717 undefined on input li ne 41742. LaTeX Warning: Hyper reference `Naxes' on page 717 undefined on input line 4174 2. LaTeX Warning: Hyper reference `CmpFrame' on page 717 undefined on input line 4 1742. LaTeX Warning: Hyper reference `MaxAxes' on page 717 undefined on input line 41 742. LaTeX Warning: Hyper reference `FrameSet' on page 717 undefined on input line 4 1742. LaTeX Warning: Hyper reference `Current' on page 717 undefined on input line 41 742. LaTeX Warning: Hyper reference `MatchEnd' on page 717 undefined on input line 4 1742. [717] LaTeX Warning: Hyper reference `Moc' on page 718 undefined on input line 41787. LaTeX Warning: Hyper reference `astAddRegion' on page 718 undefined on input li ne 41787. LaTeX Warning: Hyper reference `Region' on page 718 undefined on input line 417 87. LaTeX Warning: Hyper reference `MaxOrder' on page 718 undefined on input line 4 1787. LaTeX Warning: Hyper reference `MinRes' on page 718 undefined on input line 417 87. [718] LaTeX Warning: Hyper reference `MinOrder' on page 719 undefined on input line 4 1812. LaTeX Warning: Hyper reference `Moc' on page 719 undefined on input line 41812. [719] LaTeX Warning: Hyper reference `astGrid' on page 720 undefined on input line 41 853. LaTeX Warning: Hyper reference `Plot' on page 720 undefined on input line 41853 . [720] LaTeX Warning: Hyper reference `astGrid' on page 721 undefined on input line 41 900. LaTeX Warning: Hyper reference `Plot' on page 721 undefined on input line 41900 . LaTeX Warning: Hyper reference `MinTick(axis)' on page 721 undefined on input l ine 41900. [721] LaTeX Warning: Hyper reference `Moc' on page 722 undefined on input line 41920. [722] LaTeX Warning: Hyper reference `Moc' on page 723 undefined on input line 41967. LaTeX Warning: Hyper reference `MocChan' on page 723 undefined on input line 41 967. LaTeX Warning: Hyper reference `Object' on page 723 undefined on input line 419 67. LaTeX Warning: Hyper reference `astRead' on page 723 undefined on input line 41 967. LaTeX Warning: Hyper reference `astWrite' on page 723 undefined on input line 4 1967. [723] LaTeX Warning: Hyper reference `Moc' on page 724 undefined on input line 41988. [724] LaTeX Warning: Hyper reference `MocChan' on page 725 undefined on input line 42 012. [725] LaTeX Warning: Hyper reference `Moc' on page 726 undefined on input line 42035. [726] LaTeX Warning: Hyper reference `WcsMap' on page 727 undefined on input line 420 81. LaTeX Warning: Hyper reference `NatLon' on page 727 undefined on input line 420 81. [727] LaTeX Warning: Hyper reference `WcsMap' on page 728 undefined on input line 421 06. LaTeX Warning: Hyper reference `NatLat' on page 728 undefined on input line 421 06. [728] LaTeX Warning: Hyper reference `Frame' on page 729 undefined on input line 4214 0. LaTeX Warning: Hyper reference `FrameSet' on page 729 undefined on input line 4 2140. LaTeX Warning: Hyper reference `Current' on page 729 undefined on input line 42 140. LaTeX Warning: Hyper reference `CmpFrame' on page 729 undefined on input line 4 2140. [729] LaTeX Warning: Hyper reference `FitsChan' on page 730 undefined on input line 4 2161. [730] LaTeX Warning: Hyper reference `astAddColumn' on page 731 undefined on input li ne 42183. LaTeX Warning: Hyper reference `astRemoveColumn' on page 731 undefined on input line 42183. LaTeX Warning: Hyper reference `Table' on page 731 undefined on input line 4218 3. [731] LaTeX Warning: Hyper reference `astNorm' on page 732 undefined on input line 42 212. LaTeX Warning: Hyper reference `SkyRefIs' on page 732 undefined on input line 4 2212. LaTeX Warning: Hyper reference `SkyFrame' on page 732 undefined on input line 4 2212. [732] LaTeX Warning: Hyper reference `Region' on page 733 undefined on input line 422 43. LaTeX Warning: Hyper reference `astNegate' on page 733 undefined on input line 42243. LaTeX Warning: Hyper reference `Closed' on page 733 undefined on input line 422 43. [733] LaTeX Warning: Hyper reference `FrameSet' on page 734 undefined on input line 4 2264. [734] LaTeX Warning: Hyper reference `Mapping' on page 735 undefined on input line 42 313. LaTeX Warning: Hyper reference `CmpMap' on page 735 undefined on input line 423 13. LaTeX Warning: Hyper reference `Nout' on page 735 undefined on input line 42313 . LaTeX Warning: Hyper reference `Invert' on page 735 undefined on input line 423 13. LaTeX Warning: Hyper reference `Frame' on page 735 undefined on input line 4231 3. LaTeX Warning: Hyper reference `Naxes' on page 735 undefined on input line 4231 3. LaTeX Warning: Hyper reference `FrameSet' on page 735 undefined on input line 4 2313. LaTeX Warning: Hyper reference `Base' on page 735 undefined on input line 42313 . [735] LaTeX Warning: Hyper reference `IterInverse' on page 736 undefined on input lin e 42337. LaTeX Warning: Hyper reference `TolInverse' on page 736 undefined on input line 42337. LaTeX Warning: Hyper reference `PolyMap' on page 736 undefined on input line 42 337. [736] LaTeX Warning: Hyper reference `FitsChan' on page 737 undefined on input line 4 2361. LaTeX Warning: Hyper reference `Ncard' on page 737 undefined on input line 4236 1. [737] LaTeX Warning: Hyper reference `Object' on page 738 undefined on input line 423 87. [738] LaTeX Warning: Hyper reference `Plot3D' on page 739 undefined on input line 424 22. LaTeX Warning: Hyper reference `astText' on page 739 undefined on input line 42 422. LaTeX Warning: Hyper reference `astMark' on page 739 undefined on input line 42 422. LaTeX Warning: Hyper reference `Plot' on page 739 undefined on input line 42422 . [739] LaTeX Warning: Hyper reference `Frame' on page 740 undefined on input line 4245 5. [740] LaTeX Warning: Hyper reference `Mapping' on page 741 undefined on input line 42 505. LaTeX Warning: Hyper reference `CmpMap' on page 741 undefined on input line 425 05. LaTeX Warning: Hyper reference `Nin' on page 741 undefined on input line 42505. LaTeX Warning: Hyper reference `Invert' on page 741 undefined on input line 425 05. LaTeX Warning: Hyper reference `Frame' on page 741 undefined on input line 4250 5. LaTeX Warning: Hyper reference `Naxes' on page 741 undefined on input line 4250 5. LaTeX Warning: Hyper reference `FrameSet' on page 741 undefined on input line 4 2505. LaTeX Warning: Hyper reference `Current' on page 741 undefined on input line 42 505. [741] LaTeX Warning: Hyper reference `astAddParameter' on page 742 undefined on input line 42527. LaTeX Warning: Hyper reference `astRemoveParameter' on page 742 undefined on in put line 42527. LaTeX Warning: Hyper reference `Table' on page 742 undefined on input line 4252 7. [742] LaTeX Warning: Hyper reference `Table' on page 743 undefined on input line 4255 0. [743] LaTeX Warning: Hyper reference `astGrid' on page 744 undefined on input line 42 594. LaTeX Warning: Hyper reference `Plot' on page 744 undefined on input line 42594 . LaTeX Warning: Hyper reference `TextLab(axis)' on page 744 undefined on input l ine 42594. [744] LaTeX Warning: Hyper reference `astGrid' on page 745 undefined on input line 42 639. LaTeX Warning: Hyper reference `Plot' on page 745 undefined on input line 42639 . [745] LaTeX Warning: Hyper reference `Object' on page 746 undefined on input line 426 60. [746] LaTeX Warning: Hyper reference `Frame' on page 747 undefined on input line 4269 9. LaTeX Warning: Hyper reference `SpecFrame' on page 747 undefined on input line 42699. LaTeX Warning: Hyper reference `SkyFrame' on page 747 undefined on input line 4 2699. LaTeX Warning: Hyper reference `TimeFrame' on page 747 undefined on input line 42699. LaTeX Warning: Hyper reference `ObsLon' on page 747 undefined on input line 426 99. LaTeX Warning: Hyper reference `Epoch' on page 747 undefined on input line 4269 9. LaTeX Warning: Hyper reference `RefRA' on page 747 undefined on input line 4269 9. LaTeX Warning: Hyper reference `RefDec' on page 747 undefined on input line 426 99. [747] LaTeX Warning: Hyper reference `Frame' on page 748 undefined on input line 4274 6. LaTeX Warning: Hyper reference `SpecFrame' on page 748 undefined on input line 42746. LaTeX Warning: Hyper reference `SkyFrame' on page 748 undefined on input line 4 2746. LaTeX Warning: Hyper reference `TimeFrame' on page 748 undefined on input line 42746. LaTeX Warning: Hyper reference `ObsLon' on page 748 undefined on input line 427 46. LaTeX Warning: Hyper reference `Epoch' on page 748 undefined on input line 4274 6. LaTeX Warning: Hyper reference `RefRA' on page 748 undefined on input line 4274 6. LaTeX Warning: Hyper reference `RefDec' on page 748 undefined on input line 427 46. [748] LaTeX Warning: Hyper reference `ObsLat' on page 749 undefined on input line 427 95. LaTeX Warning: Hyper reference `Frame' on page 749 undefined on input line 4279 5. LaTeX Warning: Hyper reference `SpecFrame' on page 749 undefined on input line 42795. LaTeX Warning: Hyper reference `SkyFrame' on page 749 undefined on input line 4 2795. LaTeX Warning: Hyper reference `TimeFrame' on page 749 undefined on input line 42795. LaTeX Warning: Hyper reference `Epoch' on page 749 undefined on input line 4279 5. LaTeX Warning: Hyper reference `RefRA' on page 749 undefined on input line 4279 5. LaTeX Warning: Hyper reference `RefDec' on page 749 undefined on input line 427 95. [749] LaTeX Warning: Hyper reference `WcsMap' on page 750 undefined on input line 428 21. LaTeX Warning: Hyper reference `PVi_m' on page 750 undefined on input line 4282 1. LaTeX Warning: Hyper reference `astWcsMap' on page 750 undefined on input line 42821. [750] LaTeX Warning: Hyper reference `WcsMap' on page 751 undefined on input line 429 04. LaTeX Warning: Hyper reference `WcsType' on page 751 undefined on input line 42 904. LaTeX Warning: Hyper reference `astWcsMap' on page 751 undefined on input line 42904. LaTeX Warning: Hyper reference `CmpMap' on page 751 undefined on input line 429 04. LaTeX Warning: Hyper reference `FrameSet' on page 751 undefined on input line 4 2904. LaTeX Warning: Hyper reference `astClone' on page 751 undefined on input line 4 2904. [751] LaTeX Warning: Hyper reference `PcdMap' on page 752 undefined on input line 429 47. Overfull \hbox (59.49594pt too wide) in paragraph at lines 42947--42947 \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 752 undefined on input line 429 47. LaTeX Warning: Hyper reference `FrameSet' on page 752 undefined on input line 4 2947. LaTeX Warning: Hyper reference `astClone' on page 752 undefined on input line 4 2947. [752] LaTeX Warning: Hyper reference `Frame' on page 753 undefined on input line 4299 2. LaTeX Warning: Hyper reference `astFindFrame' on page 753 undefined on input li ne 42992. LaTeX Warning: Hyper reference `SkyFrame' on page 753 undefined on input line 4 2992. LaTeX Warning: Hyper reference `FrameSet' on page 753 undefined on input line 4 2992. LaTeX Warning: Hyper reference `Current' on page 753 undefined on input line 42 992. [753] LaTeX Warning: Hyper reference `SphMap' on page 754 undefined on input line 430 21. LaTeX Warning: Hyper reference `CmpMap' on page 754 undefined on input line 430 21. LaTeX Warning: Hyper reference `FrameSet' on page 754 undefined on input line 4 3021. LaTeX Warning: Hyper reference `astClone' on page 754 undefined on input line 4 3021. [754] LaTeX Warning: Hyper reference `FrameSet' on page 755 undefined on input line 4 3064. LaTeX Warning: Hyper reference `PVi_m' on page 755 undefined on input line 4306 4. LaTeX Warning: Hyper reference `FitsChan' on page 755 undefined on input line 4 3064. [755] LaTeX Warning: Hyper reference `Frame' on page 756 undefined on input line 4310 1. LaTeX Warning: Hyper reference `astFindFrame' on page 756 undefined on input li ne 43101. LaTeX Warning: Hyper reference `FrameSet' on page 756 undefined on input line 4 3101. LaTeX Warning: Hyper reference `Current' on page 756 undefined on input line 43 101. [756] LaTeX Warning: Hyper reference `astRead' on page 757 undefined on input line 43 131. LaTeX Warning: Hyper reference `Ident' on page 757 undefined on input line 4313 1. LaTeX Warning: Hyper reference `Mapping' on page 757 undefined on input line 43 131. LaTeX Warning: Hyper reference `ID' on page 757 undefined on input line 43131. LaTeX Warning: Hyper reference `Object' on page 757 undefined on input line 431 31. LaTeX Warning: Hyper reference `astSimplify' on page 757 undefined on input lin e 43131. Underfull \hbox (badness 10000) in paragraph at lines 43131--43131 [757] LaTeX Warning: Hyper reference `WcsMap' on page 758 undefined on input line 431 66. LaTeX Warning: Hyper reference `CmpMap' on page 758 undefined on input line 431 66. LaTeX Warning: Hyper reference `FrameSet' on page 758 undefined on input line 4 3166. LaTeX Warning: Hyper reference `astClone' on page 758 undefined on input line 4 3166. [758] LaTeX Warning: Hyper reference `SkyFrame' on page 759 undefined on input line 4 3197. LaTeX Warning: Hyper reference `Title' on page 759 undefined on input line 4319 7. [759] LaTeX Warning: Hyper reference `Object' on page 760 undefined on input line 432 22. LaTeX Warning: Hyper reference `astClone' on page 760 undefined on input line 4 3222. LaTeX Warning: Hyper reference `astAnnul' on page 760 undefined on input line 4 3222. LaTeX Warning: Hyper reference `astEnd' on page 760 undefined on input line 432 22. [760] LaTeX Warning: Hyper reference `RefRA' on page 761 undefined on input line 4324 3. LaTeX Warning: Hyper reference `SpecFrame' on page 761 undefined on input line 43243. [761] LaTeX Warning: Hyper reference `RefDec' on page 762 undefined on input line 432 92. LaTeX Warning: Hyper reference `astFindFrame' on page 762 undefined on input li ne 43292. LaTeX Warning: Hyper reference `astConvert' on page 762 undefined on input line 43292. LaTeX Warning: Hyper reference `SpecFrame' on page 762 undefined on input line 43292. LaTeX Warning: Hyper reference `CmpFrame' on page 762 undefined on input line 4 3292. LaTeX Warning: Hyper reference `astSetRefPos' on page 762 undefined on input li ne 43292. LaTeX Warning: Hyper reference `astGetRefPos' on page 762 undefined on input li ne 43292. [762] LaTeX Warning: Hyper reference `Region' on page 763 undefined on input line 433 13. LaTeX Warning: Hyper reference `Stc' on page 763 undefined on input line 43313. [763] LaTeX Warning: Hyper reference `Mapping' on page 764 undefined on input line 43 377. LaTeX Warning: Hyper reference `CmpMap' on page 764 undefined on input line 433 77. LaTeX Warning: Hyper reference `Frame' on page 764 undefined on input line 4337 7. LaTeX Warning: Hyper reference `astFormat' on page 764 undefined on input line 43377. LaTeX Warning: Hyper reference `FrameSet' on page 764 undefined on input line 4 3377. LaTeX Warning: Hyper reference `astWrite' on page 764 undefined on input line 4 3377. [764] LaTeX Warning: Hyper reference `Object' on page 765 undefined on input line 434 36. LaTeX Warning: Hyper reference `Strict' on page 765 undefined on input line 434 36. LaTeX Warning: Hyper reference `Report' on page 765 undefined on input line 434 36. LaTeX Warning: Hyper reference `Channel' on page 765 undefined on input line 43 436. LaTeX Warning: Hyper reference `astWrite' on page 765 undefined on input line 4 3436. LaTeX Warning: Hyper reference `FitsChan' on page 765 undefined on input line 4 3436. LaTeX Warning: Hyper reference `Warnings' on page 765 undefined on input line 4 3436. [765] LaTeX Warning: Hyper reference `SpecFrame' on page 766 undefined on input line 43477. [766] LaTeX Warning: Hyper reference `astGrid' on page 767 undefined on input line 43 519. LaTeX Warning: Hyper reference `astPlot3D' on page 767 undefined on input line 43519. LaTeX Warning: Hyper reference `Plot3D' on page 767 undefined on input line 435 19. LaTeX Warning: Hyper reference `Axis' on page 767 undefined on input line 43519 . [767] LaTeX Warning: Hyper reference `MathMap' on page 768 undefined on input line 43 552. [768] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 769 undefined on input li ne 43582. LaTeX Warning: Hyper reference `DSBCentre' on page 769 undefined on input line 43582. LaTeX Warning: Hyper reference `IF' on page 769 undefined on input line 43582. [769] LaTeX Warning: Hyper reference `MathMap' on page 770 undefined on input line 43 638. LaTeX Warning: Hyper reference `Mapping' on page 770 undefined on input line 43 638. LaTeX Warning: Hyper reference `UnitMap' on page 770 undefined on input line 43 638. LaTeX Warning: Hyper reference `astSimplify' on page 770 undefined on input lin e 43638. LaTeX Warning: Hyper reference `SimpIF' on page 770 undefined on input line 436 38. LaTeX Warning: Hyper reference `Invert' on page 770 undefined on input line 436 38. [770] LaTeX Warning: Hyper reference `MathMap' on page 771 undefined on input line 43 694. LaTeX Warning: Hyper reference `Mapping' on page 771 undefined on input line 43 694. LaTeX Warning: Hyper reference `UnitMap' on page 771 undefined on input line 43 694. LaTeX Warning: Hyper reference `astSimplify' on page 771 undefined on input lin e 43694. LaTeX Warning: Hyper reference `SimpFI' on page 771 undefined on input line 436 94. LaTeX Warning: Hyper reference `Invert' on page 771 undefined on input line 436 94. [771] LaTeX Warning: Hyper reference `astSimplify' on page 772 undefined on input lin e 43725. LaTeX Warning: Hyper reference `Polygon' on page 772 undefined on input line 43 725. LaTeX Warning: Hyper reference `Frame' on page 772 undefined on input line 4372 5. LaTeX Warning: Hyper reference `Mapping' on page 772 undefined on input line 43 725. [772] LaTeX Warning: Hyper reference `Channel' on page 773 undefined on input line 43 785. LaTeX Warning: Hyper reference `astWrite' on page 773 undefined on input line 4 3785. LaTeX Warning: Hyper reference `FitsChan' on page 773 undefined on input line 4 3785. LaTeX Warning: Hyper reference `astCopy' on page 773 undefined on input line 43 785. LaTeX Warning: Hyper reference `astShow' on page 773 undefined on input line 43 785. [773] Overfull \hbox (238.94087pt too wide) in paragraph at lines 43837--43837 \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 774 undefined on input line 43 837. LaTeX Warning: Hyper reference `PolyMap' on page 774 undefined on input line 43 837. LaTeX Warning: Hyper reference `FrameSet' on page 774 undefined on input line 4 3837. LaTeX Warning: Hyper reference `MatrixMap' on page 774 undefined on input line 43837. LaTeX Warning: Hyper reference `astWrite' on page 774 undefined on input line 4 3837. LaTeX Warning: Hyper reference `Mapping' on page 774 undefined on input line 43 837. LaTeX Warning: Hyper reference `FitsTol' on page 774 undefined on input line 43 837. LaTeX Warning: Hyper reference `SkyFrame' on page 774 undefined on input line 4 3837. LaTeX Warning: Hyper reference `PolyTan' on page 774 undefined on input line 43 837. LaTeX Warning: Hyper reference `FitsChan' on page 774 undefined on input line 4 3837. [774] LaTeX Warning: Hyper reference `astRead' on page 775 undefined on input line 43 868. Overfull \hbox (190.3857pt too wide) in paragraph at lines 43868--43868 \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 775 undefined on input line 4 3868. [775] LaTeX Warning: Hyper reference `Plot' on page 776 undefined on input line 43912 . [776] LaTeX Warning: Hyper reference `KeyMap' on page 777 undefined on input line 439 43. [777] LaTeX Warning: Hyper reference `Object' on page 778 undefined on input line 439 83. LaTeX Warning: Hyper reference `Channel' on page 778 undefined on input line 43 983. LaTeX Warning: Hyper reference `FitsChan' on page 778 undefined on input line 4 3983. LaTeX Warning: Hyper reference `YamlChan' on page 778 undefined on input line 4 3983. [778] LaTeX Warning: Hyper reference `SkyFrame' on page 779 undefined on input line 4 4064. LaTeX Warning: Hyper reference `System' on page 779 undefined on input line 440 64. LaTeX Warning: Hyper reference `SkyRefIs' on page 779 undefined on input line 4 4064. LaTeX Warning: Hyper reference `LonAxis' on page 779 undefined on input line 44 064. LaTeX Warning: Hyper reference `LatAxis' on page 779 undefined on input line 44 064. LaTeX Warning: Hyper reference `astConvert' on page 779 undefined on input line 44064. LaTeX Warning: Hyper reference `astFindFrame' on page 779 undefined on input li ne 44064. LaTeX Warning: Hyper reference `AlignSystem' on page 779 undefined on input lin e 44064. LaTeX Warning: Hyper reference `AlignOffset' on page 779 undefined on input lin e 44064. [779] LaTeX Warning: Hyper reference `SkyFrame' on page 780 undefined on input line 4 4100. LaTeX Warning: Hyper reference `System' on page 780 undefined on input line 441 00. [780] LaTeX Warning: Hyper reference `SkyRefIs' on page 781 undefined on input line 4 4171. LaTeX Warning: Hyper reference `System' on page 781 undefined on input line 441 71. LaTeX Warning: Hyper reference `SkyFrame' on page 781 undefined on input line 4 4171. LaTeX Warning: Hyper reference `LonAxis' on page 781 undefined on input line 44 171. LaTeX Warning: Hyper reference `LatAxis' on page 781 undefined on input line 44 171. [781] LaTeX Warning: Hyper reference `SkyFrame' on page 782 undefined on input line 4 4222. LaTeX Warning: Hyper reference `Mapping' on page 782 undefined on input line 44 222. LaTeX Warning: Hyper reference `astConvert' on page 782 undefined on input line 44222. LaTeX Warning: Hyper reference `astFindFrame' on page 782 undefined on input li ne 44222. LaTeX Warning: Hyper reference `UnitMap' on page 782 undefined on input line 44 222. LaTeX Warning: Hyper reference `FrameSet' on page 782 undefined on input line 4 4222. LaTeX Warning: Hyper reference `Epoch' on page 782 undefined on input line 4422 2. LaTeX Warning: Hyper reference `AlignSystem' on page 782 undefined on input lin e 44222. [782] LaTeX Warning: Hyper reference `astMapKey' on page 783 undefined on input line 44292. LaTeX Warning: Hyper reference `KeyMap' on page 783 undefined on input line 442 92. [783] LaTeX Warning: Hyper reference `Channel' on page 784 undefined on input line 44 352. LaTeX Warning: Hyper reference `astRead' on page 784 undefined on input line 44 352. LaTeX Warning: Hyper reference `FitsChan' on page 784 undefined on input line 4 4352. LaTeX Warning: Hyper reference `astCopy' on page 784 undefined on input line 44 352. LaTeX Warning: Hyper reference `astShow' on page 784 undefined on input line 44 352. [784] LaTeX Warning: Hyper reference `SourceVel' on page 785 undefined on input line 44401. LaTeX Warning: Hyper reference `SpecFrame' on page 785 undefined on input line 44401. [785] LaTeX Warning: Hyper reference `SourceVel' on page 786 undefined on input line 44433. LaTeX Warning: Hyper reference `StdOfRest' on page 786 undefined on input line 44433. LaTeX Warning: Hyper reference `SpecFrame' on page 786 undefined on input line 44433. [786] LaTeX Warning: Hyper reference `SourceSys' on page 787 undefined on input line 44483. LaTeX Warning: Hyper reference `SourceVRF' on page 787 undefined on input line 44483. LaTeX Warning: Hyper reference `RefRA' on page 787 undefined on input line 4448 3. LaTeX Warning: Hyper reference `RefDec' on page 787 undefined on input line 444 83. LaTeX Warning: Hyper reference `StdOfRest' on page 787 undefined on input line 44483. LaTeX Warning: Hyper reference `SpecFrame' on page 787 undefined on input line 44483. [787] LaTeX Warning: Hyper reference `SpecFrame' on page 788 undefined on input line 44518. LaTeX Warning: Hyper reference `System' on page 788 undefined on input line 445 18. [788] LaTeX Warning: Hyper reference `FluxFrame' on page 789 undefined on input line 44542. LaTeX Warning: Hyper reference `Mapping' on page 789 undefined on input line 44 542. [789] LaTeX Warning: Hyper reference `astRead' on page 790 undefined on input line 44 613. LaTeX Warning: Hyper reference `StcsChan' on page 790 undefined on input line 4 4613. LaTeX Warning: Hyper reference `Region' on page 790 undefined on input line 446 13. LaTeX Warning: Hyper reference `StcsCoords' on page 790 undefined on input line 44613. LaTeX Warning: Hyper reference `StcsProps' on page 790 undefined on input line 44613. LaTeX Warning: Hyper reference `Object' on page 790 undefined on input line 446 13. LaTeX Warning: Hyper reference `KeyMap' on page 790 undefined on input line 446 13. LaTeX Warning: Hyper reference `Prism' on page 790 undefined on input line 4461 3. LaTeX Warning: Hyper reference `astSimplify' on page 790 undefined on input lin e 44613. LaTeX Warning: Hyper reference `TimeFrame' on page 790 undefined on input line 44613. LaTeX Warning: Hyper reference `TimeOrigin' on page 790 undefined on input line 44613. LaTeX Warning: Hyper reference `Epoch' on page 790 undefined on input line 4461 3. [790] LaTeX Warning: Hyper reference `astRead' on page 791 undefined on input line 44 689. LaTeX Warning: Hyper reference `StcsChan' on page 791 undefined on input line 4 4689. LaTeX Warning: Hyper reference `PointList' on page 791 undefined on input line 44689. LaTeX Warning: Hyper reference `StcsArea' on page 791 undefined on input line 4 4689. LaTeX Warning: Hyper reference `StcsProps' on page 791 undefined on input line 44689. LaTeX Warning: Hyper reference `Object' on page 791 undefined on input line 446 89. LaTeX Warning: Hyper reference `KeyMap' on page 791 undefined on input line 446 89. LaTeX Warning: Hyper reference `TimeFrame' on page 791 undefined on input line 44689. LaTeX Warning: Hyper reference `TimeOrigin' on page 791 undefined on input line 44689. LaTeX Warning: Hyper reference `Epoch' on page 791 undefined on input line 4468 9. LaTeX Warning: Hyper reference `Region' on page 791 undefined on input line 446 89. [791] LaTeX Warning: Hyper reference `StcsChan' on page 792 undefined on input line 4 4718. LaTeX Warning: Hyper reference `Indent' on page 792 undefined on input line 447 18. [792] LaTeX Warning: Hyper reference `astRead' on page 793 undefined on input line 44 769. LaTeX Warning: Hyper reference `StcsChan' on page 793 undefined on input line 4 4769. LaTeX Warning: Hyper reference `KeyMap' on page 793 undefined on input line 447 69. LaTeX Warning: Hyper reference `StcsCoords' on page 793 undefined on input line 44769. LaTeX Warning: Hyper reference `StcsArea' on page 793 undefined on input line 4 4769. LaTeX Warning: Hyper reference `Object' on page 793 undefined on input line 447 69. [793] LaTeX Warning: Hyper reference `SpecFrame' on page 794 undefined on input line 44864. LaTeX Warning: Hyper reference `ObsLat' on page 794 undefined on input line 448 64. LaTeX Warning: Hyper reference `ObsLon' on page 794 undefined on input line 448 64. LaTeX Warning: Hyper reference `ObsAlt' on page 794 undefined on input line 448 64. LaTeX Warning: Hyper reference `Epoch' on page 794 undefined on input line 4486 4. LaTeX Warning: Hyper reference `RefRA' on page 794 undefined on input line 4486 4. LaTeX Warning: Hyper reference `RefDec' on page 794 undefined on input line 448 64. LaTeX Warning: Hyper reference `SourceVel' on page 794 undefined on input line 44864. LaTeX Warning: Hyper reference `System' on page 794 undefined on input line 448 64. [794] [795] LaTeX Warning: Hyper reference `Channel' on page 796 undefined on input line 44 904. LaTeX Warning: Hyper reference `astWarnings' on page 796 undefined on input lin e 44904. LaTeX Warning: Hyper reference `YamlChan' on page 796 undefined on input line 4 4904. LaTeX Warning: Hyper reference `Object' on page 796 undefined on input line 449 04. [796] LaTeX Warning: Hyper reference `Plot' on page 797 undefined on input line 44947 . LaTeX Warning: Hyper reference `Border' on page 797 undefined on input line 449 47. [797] LaTeX Warning: Hyper reference `Frame' on page 798 undefined on input line 4500 7. LaTeX Warning: Hyper reference `Domain' on page 798 undefined on input line 450 07. LaTeX Warning: Hyper reference `SkyFrame' on page 798 undefined on input line 4 5007. LaTeX Warning: Hyper reference `TimeFrame' on page 798 undefined on input line 45007. LaTeX Warning: Hyper reference `FrameSet' on page 798 undefined on input line 4 5007. LaTeX Warning: Hyper reference `Current' on page 798 undefined on input line 45 007. [798] LaTeX Warning: Hyper reference `SkyFrame' on page 799 undefined on input line 4 5293. LaTeX Warning: Hyper reference `SpecFrame' on page 799 undefined on input line 45293. LaTeX Warning: Hyper reference `Frame' on page 799 undefined on input line 4529 3. LaTeX Warning: Hyper reference `CmpFrame' on page 799 undefined on input line 4 5293. LaTeX Warning: Hyper reference `FrameSet' on page 799 undefined on input line 4 5293. LaTeX Warning: Hyper reference `Current' on page 799 undefined on input line 45 293. LaTeX Warning: Hyper reference `Epoch' on page 799 undefined on input line 4529 3. LaTeX Warning: Hyper reference `Equinox' on page 799 undefined on input line 45 293. [799] LaTeX Warning: Hyper reference `Mapping' on page 800 undefined on input line 45 293. [800] LaTeX Warning: Hyper reference `astSetActiveUnit' on page 801 undefined on inpu t line 45293. LaTeX Warning: Hyper reference `TimeFrame' on page 801 undefined on input line 45293. LaTeX Warning: Hyper reference `FluxFrame' on page 801 undefined on input line 45293. [801] LaTeX Warning: Hyper reference `FitsChan' on page 802 undefined on input line 4 5377. LaTeX Warning: Hyper reference `astWrite' on page 802 undefined on input line 4 5377. LaTeX Warning: Hyper reference `astRead' on page 802 undefined on input line 45 377. LaTeX Warning: Hyper reference `FrameSet' on page 802 undefined on input line 4 5377. LaTeX Warning: Hyper reference `ForceTab' on page 802 undefined on input line 4 5377. LaTeX Warning: Hyper reference `astGetTables' on page 802 undefined on input li ne 45377. LaTeX Warning: Hyper reference `FitsTable' on page 802 undefined on input line 45377. LaTeX Warning: Hyper reference `astPutTables' on page 802 undefined on input li ne 45377. LaTeX Warning: Hyper reference `astPutTable' on page 802 undefined on input lin e 45377. LaTeX Warning: Hyper reference `astTableSource' on page 802 undefined on input line 45377. [802] LaTeX Warning: Hyper reference `TitleGap' on page 803 undefined on input line 4 5406. LaTeX Warning: Hyper reference `Plot' on page 803 undefined on input line 45406 . [803] LaTeX Warning: Hyper reference `astGrid' on page 804 undefined on input line 45 458. LaTeX Warning: Hyper reference `Plot' on page 804 undefined on input line 45458 . LaTeX Warning: Hyper reference `Labelling' on page 804 undefined on input line 45458. LaTeX Warning: Hyper reference `Label(axis)' on page 804 undefined on input lin e 45458. LaTeX Warning: Hyper reference `Unit(axis)' on page 804 undefined on input line 45458. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 804 undefined on inpu t line 45458. LaTeX Warning: Hyper reference `NumLab(axis)' on page 804 undefined on input li ne 45458. [804] LaTeX Warning: Hyper reference `astGrid' on page 805 undefined on input line 45 513. LaTeX Warning: Hyper reference `Plot' on page 805 undefined on input line 45513 . LaTeX Warning: Hyper reference `TextGapType' on page 805 undefined on input lin e 45513. LaTeX Warning: Hyper reference `Labelling' on page 805 undefined on input line 45513. [805] LaTeX Warning: Hyper reference `astGrid' on page 806 undefined on input line 45 550. LaTeX Warning: Hyper reference `Plot' on page 806 undefined on input line 45550 . LaTeX Warning: Hyper reference `Edge(axis)' on page 806 undefined on input line 45550. LaTeX Warning: Hyper reference `Labelling' on page 806 undefined on input line 45550. [806] LaTeX Warning: Hyper reference `TimeFrame' on page 807 undefined on input line 45631. LaTeX Warning: Hyper reference `System' on page 807 undefined on input line 456 31. LaTeX Warning: Hyper reference `Epoch' on page 807 undefined on input line 4563 1. [807] LaTeX Warning: Hyper reference `TimeFrame' on page 808 undefined on input line 45732. LaTeX Warning: Hyper reference `System' on page 808 undefined on input line 457 32. LaTeX Warning: Hyper reference `Epoch' on page 808 undefined on input line 4573 2. LaTeX Warning: Hyper reference `Dut1' on page 808 undefined on input line 45732 . LaTeX Warning: Hyper reference `Frame' on page 808 undefined on input line 4573 2. LaTeX Warning: Hyper reference `LTOffset' on page 808 undefined on input line 4 5732. Overfull \hbox (146.29462pt too wide) in paragraph at lines 45732--45732 \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 808 undefined on input line 4 5732. [808] [809] LaTeX Warning: Hyper reference `Frame' on page 810 undefined on input line 4578 0. LaTeX Warning: Hyper reference `Naxes' on page 810 undefined on input line 4578 0. LaTeX Warning: Hyper reference `CmpFrame' on page 810 undefined on input line 4 5780. LaTeX Warning: Hyper reference `FrameSet' on page 810 undefined on input line 4 5780. LaTeX Warning: Hyper reference `Current' on page 810 undefined on input line 45 780. [810] LaTeX Warning: Hyper reference `astGrid' on page 811 undefined on input line 45 824. LaTeX Warning: Hyper reference `Plot' on page 811 undefined on input line 45824 . LaTeX Warning: Hyper reference `TextGapType' on page 811 undefined on input lin e 45824. LaTeX Warning: Hyper reference `Plot3D' on page 811 undefined on input line 458 24. LaTeX Warning: Hyper reference `Title' on page 811 undefined on input line 4582 4. [811] LaTeX Warning: Hyper reference `Plot' on page 812 undefined on input line 45852 . [812] LaTeX Warning: Hyper reference `IterInverse' on page 813 undefined on input lin e 45879. LaTeX Warning: Hyper reference `NiterInverse' on page 813 undefined on input li ne 45879. LaTeX Warning: Hyper reference `PolyMap' on page 813 undefined on input line 45 879. [813] LaTeX Warning: Hyper reference `astGrid' on page 814 undefined on input line 45 916. LaTeX Warning: Hyper reference `Frame' on page 814 undefined on input line 4591 6. LaTeX Warning: Hyper reference `SkyFrame' on page 814 undefined on input line 4 5916. [814] LaTeX Warning: Hyper reference `Mapping' on page 815 undefined on input line 45 965. LaTeX Warning: Hyper reference `CmpMap' on page 815 undefined on input line 459 65. LaTeX Warning: Hyper reference `FrameSet' on page 815 undefined on input line 4 5965. LaTeX Warning: Hyper reference `Frame' on page 815 undefined on input line 4596 5. LaTeX Warning: Hyper reference `Base' on page 815 undefined on input line 45965 . LaTeX Warning: Hyper reference `Current' on page 815 undefined on input line 45 965. [815] LaTeX Warning: Hyper reference `Mapping' on page 816 undefined on input line 46 014. LaTeX Warning: Hyper reference `CmpMap' on page 816 undefined on input line 460 14. LaTeX Warning: Hyper reference `FrameSet' on page 816 undefined on input line 4 6014. LaTeX Warning: Hyper reference `Frame' on page 816 undefined on input line 4601 4. LaTeX Warning: Hyper reference `Current' on page 816 undefined on input line 46 014. LaTeX Warning: Hyper reference `Base' on page 816 undefined on input line 46014 . [816] LaTeX Warning: Hyper reference `Frame' on page 817 undefined on input line 4608 5. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 817 undefined on inpu t line 46085. LaTeX Warning: Hyper reference `SkyFrame' on page 817 undefined on input line 4 6085. LaTeX Warning: Hyper reference `astFormat' on page 817 undefined on input line 46085. LaTeX Warning: Hyper reference `SpecFrame' on page 817 undefined on input line 46085. LaTeX Warning: Hyper reference `System' on page 817 undefined on input line 460 85. LaTeX Warning: Hyper reference `TimeFrame' on page 817 undefined on input line 46085. LaTeX Warning: Hyper reference `FrameSet' on page 817 undefined on input line 4 6085. LaTeX Warning: Hyper reference `Current' on page 817 undefined on input line 46 085. [817] LaTeX Warning: Hyper reference `SphMap' on page 818 undefined on input line 461 54. LaTeX Warning: Hyper reference `CmpMap' on page 818 undefined on input line 461 54. LaTeX Warning: Hyper reference `astSimplify' on page 818 undefined on input lin e 46154. LaTeX Warning: Hyper reference `UnitMap' on page 818 undefined on input line 46 154. LaTeX Warning: Hyper reference `FitsChan' on page 818 undefined on input line 4 6154. LaTeX Warning: Hyper reference `FrameSet' on page 818 undefined on input line 4 6154. LaTeX Warning: Hyper reference `astClone' on page 818 undefined on input line 4 6154. [818] LaTeX Warning: Hyper reference `astTest' on page 819 undefined on input line 46 242. LaTeX Warning: Hyper reference `Object' on page 819 undefined on input line 462 42. LaTeX Warning: Hyper reference `FrameSet' on page 819 undefined on input line 4 6242. LaTeX Warning: Hyper reference `Frame' on page 819 undefined on input line 4624 2. LaTeX Warning: Hyper reference `CmpFrame' on page 819 undefined on input line 4 6242. LaTeX Warning: Hyper reference `Region' on page 819 undefined on input line 462 42. LaTeX Warning: Hyper reference `Epoch' on page 819 undefined on input line 4624 2. LaTeX Warning: Hyper reference `ObsLat' on page 819 undefined on input line 462 42. LaTeX Warning: Hyper reference `ObsLon' on page 819 undefined on input line 462 42. LaTeX Warning: Hyper reference `SkyFrame' on page 819 undefined on input line 4 6242. LaTeX Warning: Hyper reference `Equinox' on page 819 undefined on input line 46 242. LaTeX Warning: Hyper reference `SpecFrame' on page 819 undefined on input line 46242. LaTeX Warning: Hyper reference `RefRA' on page 819 undefined on input line 4624 2. LaTeX Warning: Hyper reference `RefDec' on page 819 undefined on input line 462 42. LaTeX Warning: Hyper reference `RestFreq' on page 819 undefined on input line 4 6242. LaTeX Warning: Hyper reference `SourceVel' on page 819 undefined on input line 46242. LaTeX Warning: Hyper reference `StdOfRest' on page 819 undefined on input line 46242. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 819 undefined on input li ne 46242. LaTeX Warning: Hyper reference `ImagFreq' on page 819 undefined on input line 4 6242. LaTeX Warning: Hyper reference `DSBCentre' on page 819 undefined on input line 46242. LaTeX Warning: Hyper reference `IF' on page 819 undefined on input line 46242. [819] LaTeX Warning: Hyper reference `Mapping' on page 820 undefined on input line 46 344. LaTeX Warning: Hyper reference `Frame' on page 820 undefined on input line 4634 4. LaTeX Warning: Hyper reference `FrameSet' on page 820 undefined on input line 4 6344. LaTeX Warning: Hyper reference `astRemapFrame' on page 820 undefined on input l ine 46344. LaTeX Warning: Hyper reference `Domain' on page 820 undefined on input line 463 44. LaTeX Warning: Hyper reference `SkyFrame' on page 820 undefined on input line 4 6344. LaTeX Warning: Hyper reference `astAddFrame' on page 820 undefined on input lin e 46344. LaTeX Warning: Hyper reference `astAddVariant' on page 820 undefined on input l ine 46344. LaTeX Warning: Hyper reference `astMirrorVariants' on page 820 undefined on inp ut line 46344. LaTeX Warning: Hyper reference `AllVariants' on page 820 undefined on input lin e 46344. [820] [821] Underfull \hbox (badness 10000) in paragraph at lines 46365--46365 [822] LaTeX Warning: Hyper reference `Object' on page 823 undefined on input line 464 08. LaTeX Warning: Hyper reference `FitsChan' on page 823 undefined on input line 4 6408. LaTeX Warning: Hyper reference `AllWarnings' on page 823 undefined on input lin e 46408. LaTeX Warning: Hyper reference `astFindFits' on page 823 undefined on input lin e 46408. LaTeX Warning: Hyper reference `astRead' on page 823 undefined on input line 46 408. LaTeX Warning: Hyper reference `astWrite' on page 823 undefined on input line 4 6408. LaTeX Warning: Hyper reference `astDelFits' on page 823 undefined on input line 46408. LaTeX Warning: Hyper reference `Channel' on page 823 undefined on input line 46 408. LaTeX Warning: Hyper reference `astWarnings' on page 823 undefined on input lin e 46408. [823] LaTeX Warning: Hyper reference `WcsMap' on page 824 undefined on input line 464 35. LaTeX Warning: Hyper reference `astWcsMap' on page 824 undefined on input line 46435. [824] LaTeX Warning: Hyper reference `WcsMap' on page 825 undefined on input line 464 74. LaTeX Warning: Hyper reference `astWcsMap' on page 825 undefined on input line 46474. [825] LaTeX Warning: Hyper reference `Plot' on page 826 undefined on input line 46520 . LaTeX Warning: Hyper reference `Border' on page 826 undefined on input line 465 20. [826] LaTeX Warning: Hyper reference `XmlChan' on page 827 undefined on input line 46 715. LaTeX Warning: Hyper reference `astWrite' on page 827 undefined on input line 4 6715. LaTeX Warning: Hyper reference `Object' on page 827 undefined on input line 467 15. LaTeX Warning: Hyper reference `FitsChan' on page 827 undefined on input line 4 6715. LaTeX Warning: Hyper reference `Channel' on page 827 undefined on input line 46 715. LaTeX Warning: Hyper reference `StcsChan' on page 827 undefined on input line 4 6715. LaTeX Warning: Hyper reference `astRead' on page 827 undefined on input line 46 715. [827] LaTeX Warning: Hyper reference `Stc' on page 828 undefined on input line 46715. LaTeX Warning: Hyper reference `StcResourceProfile' on page 828 undefined on in put line 46715. LaTeX Warning: Hyper reference `StcSearchLocation' on page 828 undefined on inp ut line 46715. LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 828 undefined on input line 46715. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 828 undefined on in put line 46715. LaTeX Warning: Hyper reference `TimeFrame' on page 828 undefined on input line 46715. LaTeX Warning: Hyper reference `Frame' on page 828 undefined on input line 4671 5. LaTeX Warning: Hyper reference `Domain' on page 828 undefined on input line 467 15. LaTeX Warning: Hyper reference `SkyFrame' on page 828 undefined on input line 4 6715. LaTeX Warning: Hyper reference `Region' on page 828 undefined on input line 467 15. LaTeX Warning: Hyper reference `Polygon' on page 828 undefined on input line 46 715. [828] LaTeX Warning: Hyper reference `XmlChan' on page 829 undefined on input line 46 740. [829] LaTeX Warning: Hyper reference `Object' on page 830 undefined on input line 467 69. LaTeX Warning: Hyper reference `XmlChan' on page 830 undefined on input line 46 769. [830] LaTeX Warning: Hyper reference `YamlChan' on page 831 undefined on input line 4 6869. LaTeX Warning: Hyper reference `astWrite' on page 831 undefined on input line 4 6869. LaTeX Warning: Hyper reference `Object' on page 831 undefined on input line 468 69. LaTeX Warning: Hyper reference `SkyFrame' on page 831 undefined on input line 4 6869. LaTeX Warning: Hyper reference `Mapping' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `CmpMap' on page 831 undefined on input line 468 69. LaTeX Warning: Hyper reference `TranMap' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `UnitMap' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `ZoomMap' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `ShiftMap' on page 831 undefined on input line 4 6869. LaTeX Warning: Hyper reference `WinMap' on page 831 undefined on input line 468 69. LaTeX Warning: Hyper reference `MatrixMap' on page 831 undefined on input line 46869. LaTeX Warning: Hyper reference `PermMap' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `WcsMap' on page 831 undefined on input line 468 69. LaTeX Warning: Hyper reference `PolyMap' on page 831 undefined on input line 46 869. LaTeX Warning: Hyper reference `ChebyMap' on page 831 undefined on input line 4 6869. [831] LaTeX Warning: Hyper reference `ZoomMap' on page 832 undefined on input line 46 919. LaTeX Warning: Hyper reference `astInvert' on page 832 undefined on input line 46919. LaTeX Warning: Hyper reference `Mapping' on page 832 undefined on input line 46 919. LaTeX Warning: Hyper reference `Invert' on page 832 undefined on input line 469 19. LaTeX Warning: Hyper reference `CmpMap' on page 832 undefined on input line 469 19. LaTeX Warning: Hyper reference `FrameSet' on page 832 undefined on input line 4 6919. LaTeX Warning: Hyper reference `astClone' on page 832 undefined on input line 4 6919. [832] [833] LaTeX Warning: Hyper reference `Frame' on page 834 undefined on input line 4694 4. LaTeX Warning: Hyper reference `astWrite' on page 834 undefined on input line 4 6944. LaTeX Warning: Hyper reference `Object' on page 834 undefined on input line 469 44. [834] LaTeX Warning: Hyper reference `Region' on page 835 undefined on input line 469 81. LaTeX Warning: Hyper reference `Frame' on page 835 undefined on input line 4698 1. LaTeX Warning: Hyper reference `Interval' on page 835 undefined on input line 4 6981. LaTeX Warning: Hyper reference `SkyFrame' on page 835 undefined on input line 4 6981. LaTeX Warning: Hyper reference `Polygon' on page 835 undefined on input line 46 981. LaTeX Warning: Hyper reference `astBox' on page 835 undefined on input line 469 81. [835] LaTeX Warning: Hyper reference `Object' on page 836 undefined on input line 470 63. LaTeX Warning: Hyper reference `SinkFile' on page 836 undefined on input line 4 7063. LaTeX Warning: Hyper reference `SourceFile' on page 836 undefined on input line 47063. LaTeX Warning: Hyper reference `astChannel' on page 836 undefined on input line 47063. LaTeX Warning: Hyper reference `Comment' on page 836 undefined on input line 47 063. LaTeX Warning: Hyper reference `Full' on page 836 undefined on input line 47063 . LaTeX Warning: Hyper reference `Indent' on page 836 undefined on input line 470 63. LaTeX Warning: Hyper reference `ReportLevel' on page 836 undefined on input lin e 47063. LaTeX Warning: Hyper reference `SinkFile' on page 836 undefined on input line 4 7063. LaTeX Warning: Hyper reference `Skip' on page 836 undefined on input line 47063 . LaTeX Warning: Hyper reference `SourceFile' on page 836 undefined on input line 47063. LaTeX Warning: Hyper reference `Strict' on page 836 undefined on input line 470 63. LaTeX Warning: Hyper reference `astWarnings' on page 836 undefined on input lin e 47063. LaTeX Warning: Hyper reference `astPutChannelData' on page 836 undefined on inp ut line 47063. LaTeX Warning: Hyper reference `astRead' on page 836 undefined on input line 47 063. LaTeX Warning: Hyper reference `astWrite' on page 836 undefined on input line 4 7063. [836] LaTeX Warning: Hyper reference `Mapping' on page 837 undefined on input line 47 150. LaTeX Warning: Hyper reference `astPolyTran' on page 837 undefined on input lin e 47150. LaTeX Warning: Hyper reference `PolyMap' on page 837 undefined on input line 47 150. LaTeX Warning: Hyper reference `astChebyMap' on page 837 undefined on input lin e 47150. LaTeX Warning: Hyper reference `astChebyDomain' on page 837 undefined on input line 47150. [837] LaTeX Warning: Hyper reference `Region' on page 838 undefined on input line 471 86. LaTeX Warning: Hyper reference `Frame' on page 838 undefined on input line 4718 6. LaTeX Warning: Hyper reference `astCircle' on page 838 undefined on input line 47186. LaTeX Warning: Hyper reference `astCirclePars' on page 838 undefined on input l ine 47186. [838] LaTeX Warning: Hyper reference `Frame' on page 839 undefined on input line 4724 1. LaTeX Warning: Hyper reference `Mapping' on page 839 undefined on input line 47 241. LaTeX Warning: Hyper reference `UnitMap' on page 839 undefined on input line 47 241. LaTeX Warning: Hyper reference `Region' on page 839 undefined on input line 472 41. LaTeX Warning: Hyper reference `astCmpFrame' on page 839 undefined on input lin e 47241. LaTeX Warning: Hyper reference `SpecFrame' on page 839 undefined on input line 47241. LaTeX Warning: Hyper reference `SkyFrame' on page 839 undefined on input line 4 7241. LaTeX Warning: Hyper reference `Equinox' on page 839 undefined on input line 47 241. LaTeX Warning: Hyper reference `RestFreq' on page 839 undefined on input line 4 7241. [839] LaTeX Warning: Hyper reference `Mapping' on page 840 undefined on input line 47 282. LaTeX Warning: Hyper reference `astCmpMap' on page 840 undefined on input line 47282. [840] LaTeX Warning: Hyper reference `Region' on page 841 undefined on input line 473 42. LaTeX Warning: Hyper reference `Frame' on page 841 undefined on input line 4734 2. LaTeX Warning: Hyper reference `astConvert' on page 841 undefined on input line 47342. LaTeX Warning: Hyper reference `Mapping' on page 841 undefined on input line 47 342. LaTeX Warning: Hyper reference `SkyFrame' on page 841 undefined on input line 4 7342. LaTeX Warning: Hyper reference `astCmpRegion' on page 841 undefined on input li ne 47342. [841] LaTeX Warning: Hyper reference `SpecFrame' on page 842 undefined on input line 47411. LaTeX Warning: Hyper reference `SideBand' on page 842 undefined on input line 4 7411. LaTeX Warning: Hyper reference `IF' on page 842 undefined on input line 47411. LaTeX Warning: Hyper reference `astDSBSpecFrame' on page 842 undefined on input line 47411. LaTeX Warning: Hyper reference `AlignSideBand' on page 842 undefined on input l ine 47411. LaTeX Warning: Hyper reference `DSBCentre' on page 842 undefined on input line 47411. LaTeX Warning: Hyper reference `IF' on page 842 undefined on input line 47411. LaTeX Warning: Hyper reference `ImagFreq' on page 842 undefined on input line 4 7411. LaTeX Warning: Hyper reference `SideBand' on page 842 undefined on input line 4 7411. [842] LaTeX Warning: Hyper reference `Mapping' on page 843 undefined on input line 47 458. LaTeX Warning: Hyper reference `FrameSet' on page 843 undefined on input line 4 7458. LaTeX Warning: Hyper reference `astRead' on page 843 undefined on input line 47 458. LaTeX Warning: Hyper reference `FitsChan' on page 843 undefined on input line 4 7458. LaTeX Warning: Hyper reference `Encoding' on page 843 undefined on input line 4 7458. [843] LaTeX Warning: Hyper reference `Region' on page 844 undefined on input line 474 94. LaTeX Warning: Hyper reference `Frame' on page 844 undefined on input line 4749 4. LaTeX Warning: Hyper reference `astEllipse' on page 844 undefined on input line 47494. LaTeX Warning: Hyper reference `astEllipsePars' on page 844 undefined on input line 47494. [844] LaTeX Warning: Hyper reference `Channel' on page 845 undefined on input line 47 739. LaTeX Warning: Hyper reference `System' on page 845 undefined on input line 477 39. LaTeX Warning: Hyper reference `Object' on page 845 undefined on input line 477 39. LaTeX Warning: Hyper reference `astWrite' on page 845 undefined on input line 4 7739. LaTeX Warning: Hyper reference `Card' on page 845 undefined on input line 47739 . LaTeX Warning: Hyper reference `astFindFits' on page 845 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astPutFits' on page 845 undefined on input line 47739. LaTeX Warning: Hyper reference `astPutCards' on page 845 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 845 undefined on inp ut line 47739. LaTeX Warning: Hyper reference `astDelFits' on page 845 undefined on input line 47739. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 845 undefined on inp ut line 47739. LaTeX Warning: Hyper reference `SourceFile' on page 845 undefined on input line 47739. LaTeX Warning: Hyper reference `SinkFile' on page 845 undefined on input line 4 7739. LaTeX Warning: Hyper reference `astRead' on page 845 undefined on input line 47 739. LaTeX Warning: Hyper reference `Encoding' on page 845 undefined on input line 4 7739. LaTeX Warning: Hyper reference `astRetainFits' on page 845 undefined on input l ine 47739. [845] LaTeX Warning: Hyper reference `astFitsChan' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `AllWarnings' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `AltAxes' on page 846 undefined on input line 47 739. LaTeX Warning: Hyper reference `Card' on page 846 undefined on input line 47739 . LaTeX Warning: Hyper reference `CardComm' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `CardName' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `CardType' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `CarLin' on page 846 undefined on input line 477 39. LaTeX Warning: Hyper reference `CDMatrix' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `Clean' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `DefB1950' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `Encoding' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 846 undefined on input l ine 47739. LaTeX Warning: Hyper reference `FitsDigits' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `FitsRounding' on page 846 undefined on input li ne 47739. LaTeX Warning: Hyper reference `ForceTab' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `Iwc' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `Frame' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `Ncard' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `Nkey' on page 846 undefined on input line 47739 . LaTeX Warning: Hyper reference `PolyTan' on page 846 undefined on input line 47 739. LaTeX Warning: Hyper reference `PVi_m' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `SipReplace' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `SipOK' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `SipReplace' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `TabOK' on page 846 undefined on input line 4773 9. LaTeX Warning: Hyper reference `Warnings' on page 846 undefined on input line 4 7739. LaTeX Warning: Hyper reference `astDelFits' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `astEmptyFits' on page 846 undefined on input li ne 47739. LaTeX Warning: Hyper reference `astFindFits' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 846 undefined on inp ut line 47739. LaTeX Warning: Hyper reference `astGetTables' on page 846 undefined on input li ne 47739. LaTeX Warning: Hyper reference `astPurgeWCS' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astPutCards' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astPutFits' on page 846 undefined on input line 47739. LaTeX Warning: Hyper reference `astPutTable' on page 846 undefined on input lin e 47739. LaTeX Warning: Hyper reference `FitsTable' on page 846 undefined on input line 47739. [846] LaTeX Warning: Hyper reference `astPutTables' on page 847 undefined on input li ne 47739. LaTeX Warning: Hyper reference `astReadFits' on page 847 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astRemoveTables' on page 847 undefined on input line 47739. LaTeX Warning: Hyper reference `astRetainFits' on page 847 undefined on input l ine 47739. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 847 undefined on inp ut line 47739. LaTeX Warning: Hyper reference `astShowFits' on page 847 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astTableSource' on page 847 undefined on input line 47739. LaTeX Warning: Hyper reference `astTestFits' on page 847 undefined on input lin e 47739. LaTeX Warning: Hyper reference `astWriteFits' on page 847 undefined on input li ne 47739. [847] LaTeX Warning: Hyper reference `Table' on page 848 undefined on input line 4780 4. LaTeX Warning: Hyper reference `FitsChan' on page 848 undefined on input line 4 7804. LaTeX Warning: Hyper reference `astFitsTable' on page 848 undefined on input li ne 47804. LaTeX Warning: Hyper reference `astColumnNull' on page 848 undefined on input l ine 47804. LaTeX Warning: Hyper reference `astColumnSize' on page 848 undefined on input l ine 47804. LaTeX Warning: Hyper reference `astGetColumnData' on page 848 undefined on inpu t line 47804. LaTeX Warning: Hyper reference `astGetTableHeader' on page 848 undefined on inp ut line 47804. LaTeX Warning: Hyper reference `astPutColumnData' on page 848 undefined on inpu t line 47804. LaTeX Warning: Hyper reference `astPutTableHeader' on page 848 undefined on inp ut line 47804. [848] LaTeX Warning: Hyper reference `Frame' on page 849 undefined on input line 4784 8. LaTeX Warning: Hyper reference `System' on page 849 undefined on input line 478 48. LaTeX Warning: Hyper reference `SpecVal' on page 849 undefined on input line 47 848. LaTeX Warning: Hyper reference `astFluxFrame' on page 849 undefined on input li ne 47848. LaTeX Warning: Hyper reference `SpecVal' on page 849 undefined on input line 47 848. [849] LaTeX Warning: Hyper reference `Title' on page 850 undefined on input line 4805 3. LaTeX Warning: Hyper reference `astFrame' on page 850 undefined on input line 4 8053. LaTeX Warning: Hyper reference `Mapping' on page 850 undefined on input line 48 053. LaTeX Warning: Hyper reference `UnitMap' on page 850 undefined on input line 48 053. LaTeX Warning: Hyper reference `Nin' on page 850 undefined on input line 48053. LaTeX Warning: Hyper reference `Nout' on page 850 undefined on input line 48053 . LaTeX Warning: Hyper reference `AlignSystem' on page 850 undefined on input lin e 48053. LaTeX Warning: Hyper reference `Bottom(axis)' on page 850 undefined on input li ne 48053. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 850 undefined on i nput line 48053. LaTeX Warning: Hyper reference `Direction(axis)' on page 850 undefined on input line 48053. LaTeX Warning: Hyper reference `Domain' on page 850 undefined on input line 480 53. LaTeX Warning: Hyper reference `Dtai' on page 850 undefined on input line 48053 . LaTeX Warning: Hyper reference `Dut1' on page 850 undefined on input line 48053 . LaTeX Warning: Hyper reference `Epoch' on page 850 undefined on input line 4805 3. LaTeX Warning: Hyper reference `Format(axis)' on page 850 undefined on input li ne 48053. LaTeX Warning: Hyper reference `InternalUnit(axis)' on page 850 undefined on in put line 48053. LaTeX Warning: Hyper reference `Label(axis)' on page 850 undefined on input lin e 48053. LaTeX Warning: Hyper reference `Axis' on page 850 undefined on input line 48053 . LaTeX Warning: Hyper reference `MatchEnd' on page 850 undefined on input line 4 8053. LaTeX Warning: Hyper reference `MaxAxes' on page 850 undefined on input line 48 053. LaTeX Warning: Hyper reference `MinAxes' on page 850 undefined on input line 48 053. LaTeX Warning: Hyper reference `Naxes' on page 850 undefined on input line 4805 3. LaTeX Warning: Hyper reference `NormUnit(axis)' on page 850 undefined on input line 48053. LaTeX Warning: Hyper reference `ObsAlt' on page 850 undefined on input line 480 53. LaTeX Warning: Hyper reference `ObsLat' on page 850 undefined on input line 480 53. LaTeX Warning: Hyper reference `ObsLon' on page 850 undefined on input line 480 53. [850] LaTeX Warning: Hyper reference `Permute' on page 851 undefined on input line 48 053. LaTeX Warning: Hyper reference `PreserveAxes' on page 851 undefined on input li ne 48053. LaTeX Warning: Hyper reference `Symbol(axis)' on page 851 undefined on input li ne 48053. LaTeX Warning: Hyper reference `System' on page 851 undefined on input line 480 53. LaTeX Warning: Hyper reference `Title' on page 851 undefined on input line 4805 3. LaTeX Warning: Hyper reference `Top(axis)' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `Unit(axis)' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astAngle' on page 851 undefined on input line 4 8053. LaTeX Warning: Hyper reference `astAxAngle' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astAxDistance' on page 851 undefined on input l ine 48053. LaTeX Warning: Hyper reference `astAxNorm' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astAxOffset' on page 851 undefined on input lin e 48053. LaTeX Warning: Hyper reference `astConvert' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astDistance' on page 851 undefined on input lin e 48053. LaTeX Warning: Hyper reference `astFindFrame' on page 851 undefined on input li ne 48053. LaTeX Warning: Hyper reference `astFormat' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astGetActiveUnit' on page 851 undefined on inpu t line 48053. LaTeX Warning: Hyper reference `astIntersect' on page 851 undefined on input li ne 48053. LaTeX Warning: Hyper reference `astMatchAxes' on page 851 undefined on input li ne 48053. LaTeX Warning: Hyper reference `astNorm' on page 851 undefined on input line 48 053. LaTeX Warning: Hyper reference `astNormPoints' on page 851 undefined on input l ine 48053. LaTeX Warning: Hyper reference `astOffset' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astOffset2' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astPermAxes' on page 851 undefined on input lin e 48053. LaTeX Warning: Hyper reference `astPickAxes' on page 851 undefined on input lin e 48053. LaTeX Warning: Hyper reference `astResolve' on page 851 undefined on input line 48053. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 851 undefined on inpu t line 48053. LaTeX Warning: Hyper reference `astUnformat' on page 851 undefined on input lin e 48053. [851] LaTeX Warning: Hyper reference `Mapping' on page 852 undefined on input line 48 176. LaTeX Warning: Hyper reference `Frame' on page 852 undefined on input line 4817 6. LaTeX Warning: Hyper reference `Base' on page 852 undefined on input line 48176 . LaTeX Warning: Hyper reference `Current' on page 852 undefined on input line 48 176. LaTeX Warning: Hyper reference `Title' on page 852 undefined on input line 4817 6. LaTeX Warning: Hyper reference `astInvert' on page 852 undefined on input line 48176. LaTeX Warning: Hyper reference `Region' on page 852 undefined on input line 481 76. LaTeX Warning: Hyper reference `astFrameSet' on page 852 undefined on input lin e 48176. LaTeX Warning: Hyper reference `AllVariants' on page 852 undefined on input lin e 48176. LaTeX Warning: Hyper reference `Base' on page 852 undefined on input line 48176 . LaTeX Warning: Hyper reference `Current' on page 852 undefined on input line 48 176. LaTeX Warning: Hyper reference `Nframe' on page 852 undefined on input line 481 76. LaTeX Warning: Hyper reference `Variant' on page 852 undefined on input line 48 176. LaTeX Warning: Hyper reference `Equinox' on page 852 undefined on input line 48 176. LaTeX Warning: Hyper reference `SkyFrame' on page 852 undefined on input line 4 8176. [852] LaTeX Warning: Hyper reference `astAddFrame' on page 853 undefined on input lin e 48176. LaTeX Warning: Hyper reference `astAddVariant' on page 853 undefined on input l ine 48176. LaTeX Warning: Hyper reference `astGetFrame' on page 853 undefined on input lin e 48176. LaTeX Warning: Hyper reference `astGetMapping' on page 853 undefined on input l ine 48176. LaTeX Warning: Hyper reference `astMirrorVariants' on page 853 undefined on inp ut line 48176. LaTeX Warning: Hyper reference `astRemapFrame' on page 853 undefined on input l ine 48176. LaTeX Warning: Hyper reference `astRemoveFrame' on page 853 undefined on input line 48176. [853] LaTeX Warning: Hyper reference `Mapping' on page 854 undefined on input line 48 247. LaTeX Warning: Hyper reference `GrismWaveR' on page 854 undefined on input line 48247. LaTeX Warning: Hyper reference `GrismNRP' on page 854 undefined on input line 4 8247. LaTeX Warning: Hyper reference `GrismG' on page 854 undefined on input line 482 47. LaTeX Warning: Hyper reference `astGrismMap' on page 854 undefined on input lin e 48247. LaTeX Warning: Hyper reference `GrismNR' on page 854 undefined on input line 48 247. LaTeX Warning: Hyper reference `GrismNRP' on page 854 undefined on input line 4 8247. LaTeX Warning: Hyper reference `GrismWaveR' on page 854 undefined on input line 48247. LaTeX Warning: Hyper reference `GrismAlpha' on page 854 undefined on input line 48247. LaTeX Warning: Hyper reference `GrismG' on page 854 undefined on input line 482 47. LaTeX Warning: Hyper reference `GrismM' on page 854 undefined on input line 482 47. LaTeX Warning: Hyper reference `GrismEps' on page 854 undefined on input line 4 8247. LaTeX Warning: Hyper reference `GrismTheta' on page 854 undefined on input line 48247. [854] LaTeX Warning: Hyper reference `Region' on page 855 undefined on input line 482 89. LaTeX Warning: Hyper reference `Frame' on page 855 undefined on input line 4828 9. LaTeX Warning: Hyper reference `SkyFrame' on page 855 undefined on input line 4 8289. LaTeX Warning: Hyper reference `Box' on page 855 undefined on input line 48289. LaTeX Warning: Hyper reference `astInterval' on page 855 undefined on input lin e 48289. [855] LaTeX Warning: Hyper reference `Mapping' on page 856 undefined on input line 48 338. LaTeX Warning: Hyper reference `astIntraReg' on page 856 undefined on input lin e 48338. LaTeX Warning: Hyper reference `astIntraMap' on page 856 undefined on input lin e 48338. LaTeX Warning: Hyper reference `IntraFlag' on page 856 undefined on input line 48338. [856] LaTeX Warning: Hyper reference `KeyCase' on page 857 undefined on input line 48 459. LaTeX Warning: Hyper reference `Object' on page 857 undefined on input line 484 59. LaTeX Warning: Hyper reference `Mapping' on page 857 undefined on input line 48 459. LaTeX Warning: Hyper reference `astKeyMap' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `KeyCase' on page 857 undefined on input line 48 459. LaTeX Warning: Hyper reference `KeyError' on page 857 undefined on input line 4 8459. LaTeX Warning: Hyper reference `Report' on page 857 undefined on input line 484 59. LaTeX Warning: Hyper reference `SizeGuess' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `SortBy' on page 857 undefined on input line 484 59. LaTeX Warning: Hyper reference `MapLocked' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapCopy' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapCopyEntry' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapDefined' on page 857 undefined on input l ine 48459. LaTeX Warning: Hyper reference `astMapGet0$<$X$>$' on page 857 undefined on inp ut line 48459. LaTeX Warning: Hyper reference `astMapGet1$<$X$>$' on page 857 undefined on inp ut line 48459. LaTeX Warning: Hyper reference `astMapGetC' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapGetElem$<$X$>$' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapHasKey' on page 857 undefined on input li ne 48459. LaTeX Warning: Hyper reference `astMapKey' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapLenC' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapLength' on page 857 undefined on input li ne 48459. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 857 undefined on inp ut line 48459. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 857 undefined on inp ut line 48459. LaTeX Warning: Hyper reference `astMapPutElem$<$X$>$' on page 857 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapPutU' on page 857 undefined on input line 48459. [857] LaTeX Warning: Hyper reference `astMapRemove' on page 858 undefined on input li ne 48459. LaTeX Warning: Hyper reference `astMapRename' on page 858 undefined on input li ne 48459. LaTeX Warning: Hyper reference `astMapSize' on page 858 undefined on input line 48459. LaTeX Warning: Hyper reference `astMapType' on page 858 undefined on input line 48459. [858] LaTeX Warning: Hyper reference `Mapping' on page 859 undefined on input line 48 518. LaTeX Warning: Hyper reference `astLutMap' on page 859 undefined on input line 48518. LaTeX Warning: Hyper reference `LutEpsilon' on page 859 undefined on input line 48518. LaTeX Warning: Hyper reference `LutInterp' on page 859 undefined on input line 48518. [859] LaTeX Warning: Hyper reference `Object' on page 860 undefined on input line 486 37. LaTeX Warning: Hyper reference `Invert' on page 860 undefined on input line 486 37. LaTeX Warning: Hyper reference `IsLinear' on page 860 undefined on input line 4 8637. LaTeX Warning: Hyper reference `IsSimple' on page 860 undefined on input line 4 8637. LaTeX Warning: Hyper reference `Nin' on page 860 undefined on input line 48637. LaTeX Warning: Hyper reference `Nout' on page 860 undefined on input line 48637 . LaTeX Warning: Hyper reference `Report' on page 860 undefined on input line 486 37. LaTeX Warning: Hyper reference `TranForward' on page 860 undefined on input lin e 48637. LaTeX Warning: Hyper reference `TranInverse' on page 860 undefined on input lin e 48637. LaTeX Warning: Hyper reference `astDecompose' on page 860 undefined on input li ne 48637. LaTeX Warning: Hyper reference `astTranGrid' on page 860 undefined on input lin e 48637. LaTeX Warning: Hyper reference `astInvert' on page 860 undefined on input line 48637. LaTeX Warning: Hyper reference `astLinearApprox' on page 860 undefined on input line 48637. LaTeX Warning: Hyper reference `astMapBox' on page 860 undefined on input line 48637. LaTeX Warning: Hyper reference `astMapSplit' on page 860 undefined on input lin e 48637. LaTeX Warning: Hyper reference `astQuadApprox' on page 860 undefined on input l ine 48637. LaTeX Warning: Hyper reference `astRate' on page 860 undefined on input line 48 637. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 860 undefined on input line 48637. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 860 undefined on in put line 48637. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 860 undefined on in put line 48637. LaTeX Warning: Hyper reference `astRemoveRegions' on page 860 undefined on inpu t line 48637. LaTeX Warning: Hyper reference `astSimplify' on page 860 undefined on input lin e 48637. LaTeX Warning: Hyper reference `astTran1' on page 860 undefined on input line 4 8637. [860] LaTeX Warning: Hyper reference `astTran2' on page 861 undefined on input line 4 8637. LaTeX Warning: Hyper reference `astTranN' on page 861 undefined on input line 4 8637. LaTeX Warning: Hyper reference `astTranP' on page 861 undefined on input line 4 8637. [861] LaTeX Warning: Hyper reference `Mapping' on page 862 undefined on input line 48 686. LaTeX Warning: Hyper reference `IntraMap' on page 862 undefined on input line 4 8686. LaTeX Warning: Hyper reference `astMathMap' on page 862 undefined on input line 48686. LaTeX Warning: Hyper reference `Seed' on page 862 undefined on input line 48686 . LaTeX Warning: Hyper reference `SimpFI' on page 862 undefined on input line 486 86. LaTeX Warning: Hyper reference `SimpIF' on page 862 undefined on input line 486 86. [862] LaTeX Warning: Hyper reference `Mapping' on page 863 undefined on input line 48 720. LaTeX Warning: Hyper reference `astMatrixMap' on page 863 undefined on input li ne 48720. [863] LaTeX Warning: Hyper reference `Region' on page 864 undefined on input line 488 41. LaTeX Warning: Hyper reference `Adaptive' on page 864 undefined on input line 4 8841. LaTeX Warning: Hyper reference `astMoc' on page 864 undefined on input line 488 41. LaTeX Warning: Hyper reference `astGetMocData' on page 864 undefined on input l ine 48841. LaTeX Warning: Hyper reference `astGetMocHeader' on page 864 undefined on input line 48841. LaTeX Warning: Hyper reference `astAddMocData' on page 864 undefined on input l ine 48841. LaTeX Warning: Hyper reference `MaxOrder' on page 864 undefined on input line 4 8841. LaTeX Warning: Hyper reference `MaxRes' on page 864 undefined on input line 488 41. LaTeX Warning: Hyper reference `MinOrder' on page 864 undefined on input line 4 8841. LaTeX Warning: Hyper reference `MinRes' on page 864 undefined on input line 488 41. LaTeX Warning: Hyper reference `MocArea' on page 864 undefined on input line 48 841. LaTeX Warning: Hyper reference `MocLength' on page 864 undefined on input line 48841. LaTeX Warning: Hyper reference `MocType' on page 864 undefined on input line 48 841. LaTeX Warning: Hyper reference `astAddCell' on page 864 undefined on input line 48841. LaTeX Warning: Hyper reference `astAddMocData' on page 864 undefined on input l ine 48841. [864] LaTeX Warning: Hyper reference `astAddMocString' on page 865 undefined on input line 48841. LaTeX Warning: Hyper reference `astAddPixelMask$<$X$>$' on page 865 undefined o n input line 48841. LaTeX Warning: Hyper reference `astAddRegion' on page 865 undefined on input li ne 48841. LaTeX Warning: Hyper reference `astGetCell' on page 865 undefined on input line 48841. LaTeX Warning: Hyper reference `astGetMocData' on page 865 undefined on input l ine 48841. LaTeX Warning: Hyper reference `astGetMocHeader' on page 865 undefined on input line 48841. LaTeX Warning: Hyper reference `astGetMocString' on page 865 undefined on input line 48841. LaTeX Warning: Hyper reference `astTestCell' on page 865 undefined on input lin e 48841. [865] LaTeX Warning: Hyper reference `Channel' on page 866 undefined on input line 48 899. LaTeX Warning: Hyper reference `Moc' on page 866 undefined on input line 48899. LaTeX Warning: Hyper reference `astWrite' on page 866 undefined on input line 4 8899. LaTeX Warning: Hyper reference `SinkFile' on page 866 undefined on input line 4 8899. LaTeX Warning: Hyper reference `SourceFile' on page 866 undefined on input line 48899. LaTeX Warning: Hyper reference `astMocChan' on page 866 undefined on input line 48899. LaTeX Warning: Hyper reference `MocFormat' on page 866 undefined on input line 48899. LaTeX Warning: Hyper reference `MocLineLen' on page 866 undefined on input line 48899. [866] LaTeX Warning: Hyper reference `Mapping' on page 867 undefined on input line 48 943. LaTeX Warning: Hyper reference `astNorm' on page 867 undefined on input line 48 943. LaTeX Warning: Hyper reference `Frame' on page 867 undefined on input line 4894 3. LaTeX Warning: Hyper reference `astSimplify' on page 867 undefined on input lin e 48943. LaTeX Warning: Hyper reference `UnitMap' on page 867 undefined on input line 48 943. LaTeX Warning: Hyper reference `CmpMap' on page 867 undefined on input line 489 43. LaTeX Warning: Hyper reference `astNormMap' on page 867 undefined on input line 48943. [867] LaTeX Warning: Hyper reference `Region' on page 868 undefined on input line 489 76. LaTeX Warning: Hyper reference `Frame' on page 868 undefined on input line 4897 6. LaTeX Warning: Hyper reference `Negated' on page 868 undefined on input line 48 976. LaTeX Warning: Hyper reference `astNullRegion' on page 868 undefined on input l ine 48976. [868] LaTeX Warning: Hyper reference `Class' on page 869 undefined on input line 4911 9. LaTeX Warning: Hyper reference `ID' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `Ident' on page 869 undefined on input line 4911 9. LaTeX Warning: Hyper reference `Nobject' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `ObjSize' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `RefCount' on page 869 undefined on input line 4 9119. LaTeX Warning: Hyper reference `UseDefs' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `astAnnul' on page 869 undefined on input line 4 9119. LaTeX Warning: Hyper reference `astBegin' on page 869 undefined on input line 4 9119. LaTeX Warning: Hyper reference `astClear' on page 869 undefined on input line 4 9119. LaTeX Warning: Hyper reference `astClone' on page 869 undefined on input line 4 9119. LaTeX Warning: Hyper reference `astCopy' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `astCreatedAt' on page 869 undefined on input li ne 49119. LaTeX Warning: Hyper reference `astDelete' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astEnd' on page 869 undefined on input line 491 19. LaTeX Warning: Hyper reference `astEscapes' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astExempt' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astExport' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 869 undefined on input l ine 49119. LaTeX Warning: Hyper reference `astHasAttribute' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astImport' on page 869 undefined on input line 49119. LaTeX Warning: Hyper reference `astIsA$<$Class$>$' on page 869 undefined on inp ut line 49119. LaTeX Warning: Hyper reference `astLock' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `astToString' on page 869 undefined on input lin e 49119. LaTeX Warning: Hyper reference `astSame' on page 869 undefined on input line 49 119. LaTeX Warning: Hyper reference `astSet' on page 869 undefined on input line 491 19. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 869 undefined on input l ine 49119. [869] LaTeX Warning: Hyper reference `astShow' on page 870 undefined on input line 49 119. LaTeX Warning: Hyper reference `astTest' on page 870 undefined on input line 49 119. LaTeX Warning: Hyper reference `astThread' on page 870 undefined on input line 49119. LaTeX Warning: Hyper reference `astTune' on page 870 undefined on input line 49 119. LaTeX Warning: Hyper reference `astTuneC' on page 870 undefined on input line 4 9119. LaTeX Warning: Hyper reference `astUnlock' on page 870 undefined on input line 49119. LaTeX Warning: Hyper reference `astFromString' on page 870 undefined on input l ine 49119. LaTeX Warning: Hyper reference `astVersion' on page 870 undefined on input line 49119. [870] LaTeX Warning: Hyper reference `Mapping' on page 871 undefined on input line 49 176. LaTeX Warning: Hyper reference `Disco' on page 871 undefined on input line 4917 6. LaTeX Warning: Hyper reference `astPcdMap' on page 871 undefined on input line 49176. LaTeX Warning: Hyper reference `Disco' on page 871 undefined on input line 4917 6. LaTeX Warning: Hyper reference `PcdCen(axis)' on page 871 undefined on input li ne 49176. [871] LaTeX Warning: Hyper reference `Mapping' on page 872 undefined on input line 49 212. LaTeX Warning: Hyper reference `astPermMap' on page 872 undefined on input line 49212. [872] LaTeX Warning: Hyper reference `FrameSet' on page 873 undefined on input line 4 9524. LaTeX Warning: Hyper reference `Frame' on page 873 undefined on input line 4952 4. LaTeX Warning: Hyper reference `Mapping' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `astCurve' on page 873 undefined on input line 4 9524. LaTeX Warning: Hyper reference `astGenCurve' on page 873 undefined on input lin e 49524. LaTeX Warning: Hyper reference `astPolyCurve' on page 873 undefined on input li ne 49524. LaTeX Warning: Hyper reference `astMark' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `astText' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `astGridLine' on page 873 undefined on input lin e 49524. LaTeX Warning: Hyper reference `astGrid' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `Current' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `astClip' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `astPlot' on page 873 undefined on input line 49 524. LaTeX Warning: Hyper reference `Border' on page 873 undefined on input line 495 24. LaTeX Warning: Hyper reference `Clip' on page 873 undefined on input line 49524 . LaTeX Warning: Hyper reference `ClipOp' on page 873 undefined on input line 495 24. LaTeX Warning: Hyper reference `Colour(element)' on page 873 undefined on input line 49524. LaTeX Warning: Hyper reference `DrawAxes(axis)' on page 873 undefined on input line 49524. LaTeX Warning: Hyper reference `DrawTitle' on page 873 undefined on input line 49524. LaTeX Warning: Hyper reference `Escape' on page 873 undefined on input line 495 24. LaTeX Warning: Hyper reference `Edge(axis)' on page 873 undefined on input line 49524. LaTeX Warning: Hyper reference `Font(element)' on page 873 undefined on input l ine 49524. [873] LaTeX Warning: Hyper reference `Gap(axis)' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `Interval' on page 874 undefined on input line 4 9524. LaTeX Warning: Hyper reference `Grf' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `Grid' on page 874 undefined on input line 49524 . LaTeX Warning: Hyper reference `Invisible' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `LabelAt(axis)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 874 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `LabelUp(axis)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `Labelling' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `LogGap(axis)' on page 874 undefined on input li ne 49524. LaTeX Warning: Hyper reference `LogPlot(axis)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `LogTicks(axis)' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `MajTickLen(axis)' on page 874 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `MinTickLen(axis)' on page 874 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `MinTick(axis)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `NumLab(axis)' on page 874 undefined on input li ne 49524. LaTeX Warning: Hyper reference `NumLabGap(axis)' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `Size(element)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `Style(element)' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `TextGapType' on page 874 undefined on input lin e 49524. LaTeX Warning: Hyper reference `TitleGap' on page 874 undefined on input line 4 9524. LaTeX Warning: Hyper reference `TextLab(axis)' on page 874 undefined on input l ine 49524. LaTeX Warning: Hyper reference `TextLabGap(axis)' on page 874 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `TickAll' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `TitleGap' on page 874 undefined on input line 4 9524. LaTeX Warning: Hyper reference `Tol' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `Width(element)' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astBBuf' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `astBorder' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astBoundingBox' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astClip' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `astCurve' on page 874 undefined on input line 4 9524. LaTeX Warning: Hyper reference `astEBuf' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `astGenCurve' on page 874 undefined on input lin e 49524. LaTeX Warning: Hyper reference `astGetGrfContext' on page 874 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `astGrfPop' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astGrfPush' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astGrfSet' on page 874 undefined on input line 49524. LaTeX Warning: Hyper reference `astGrid' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `astGridLine' on page 874 undefined on input lin e 49524. LaTeX Warning: Hyper reference `astMark' on page 874 undefined on input line 49 524. LaTeX Warning: Hyper reference `astPolyCurve' on page 874 undefined on input li ne 49524. [874] LaTeX Warning: Hyper reference `astRegionOutline' on page 875 undefined on inpu t line 49524. LaTeX Warning: Hyper reference `Region' on page 875 undefined on input line 495 24. LaTeX Warning: Hyper reference `astText' on page 875 undefined on input line 49 524. LaTeX Warning: Hyper reference `Axis' on page 875 undefined on input line 49524 . LaTeX Warning: Hyper reference `Title' on page 875 undefined on input line 4952 4. [875] LaTeX Warning: Hyper reference `Plot' on page 876 undefined on input line 49645 . LaTeX Warning: Hyper reference `Frame' on page 876 undefined on input line 4964 5. LaTeX Warning: Hyper reference `ast_link' on page 876 undefined on input line 4 9645. LaTeX Warning: Hyper reference `Current' on page 876 undefined on input line 49 645. LaTeX Warning: Hyper reference `FrameSet' on page 876 undefined on input line 4 9645. LaTeX Warning: Hyper reference `Mapping' on page 876 undefined on input line 49 645. LaTeX Warning: Hyper reference `astClip' on page 876 undefined on input line 49 645. LaTeX Warning: Hyper reference `astGrfSet' on page 876 undefined on input line 49645. LaTeX Warning: Hyper reference `astGrfPop' on page 876 undefined on input line 49645. LaTeX Warning: Hyper reference `astGrfPush' on page 876 undefined on input line 49645. LaTeX Warning: Hyper reference `astGetGrfContext' on page 876 undefined on inpu t line 49645. LaTeX Warning: Hyper reference `astPlot3D' on page 876 undefined on input line 49645. [876] LaTeX Warning: Hyper reference `RootCorner' on page 877 undefined on input line 49645. LaTeX Warning: Hyper reference `DrawTitle' on page 877 undefined on input line 49645. LaTeX Warning: Hyper reference `TitleGap' on page 877 undefined on input line 4 9645. LaTeX Warning: Hyper reference `Grid' on page 877 undefined on input line 49645 . LaTeX Warning: Hyper reference `astBoundingBox' on page 877 undefined on input line 49645. LaTeX Warning: Hyper reference `astCurve' on page 877 undefined on input line 4 9645. LaTeX Warning: Hyper reference `astGenCurve' on page 877 undefined on input lin e 49645. LaTeX Warning: Hyper reference `astGridLine' on page 877 undefined on input lin e 49645. LaTeX Warning: Hyper reference `astPolyCurve' on page 877 undefined on input li ne 49645. [877] LaTeX Warning: Hyper reference `Region' on page 878 undefined on input line 496 81. LaTeX Warning: Hyper reference `Frame' on page 878 undefined on input line 4968 1. LaTeX Warning: Hyper reference `astPointList' on page 878 undefined on input li ne 49681. LaTeX Warning: Hyper reference `ListSize' on page 878 undefined on input line 4 9681. [878] LaTeX Warning: Hyper reference `Mapping' on page 879 undefined on input line 49 738. LaTeX Warning: Hyper reference `IterInverse' on page 879 undefined on input lin e 49738. LaTeX Warning: Hyper reference `astPolyMap' on page 879 undefined on input line 49738. LaTeX Warning: Hyper reference `IterInverse' on page 879 undefined on input lin e 49738. LaTeX Warning: Hyper reference `NiterInverse' on page 879 undefined on input li ne 49738. LaTeX Warning: Hyper reference `TolInverse' on page 879 undefined on input line 49738. LaTeX Warning: Hyper reference `astPolyCoeffs' on page 879 undefined on input l ine 49738. LaTeX Warning: Hyper reference `astPolyTran' on page 879 undefined on input lin e 49738. [879] LaTeX Warning: Hyper reference `Frame' on page 880 undefined on input line 4980 7. LaTeX Warning: Hyper reference `SkyFrame' on page 880 undefined on input line 4 9807. LaTeX Warning: Hyper reference `astPolygon' on page 880 undefined on input line 49807. LaTeX Warning: Hyper reference `Region' on page 880 undefined on input line 498 07. LaTeX Warning: Hyper reference `SimpVertices' on page 880 undefined on input li ne 49807. LaTeX Warning: Hyper reference `astDownsize' on page 880 undefined on input lin e 49807. LaTeX Warning: Hyper reference `astConvex$<$X$>$' on page 880 undefined on inpu t line 49807. LaTeX Warning: Hyper reference `astOutline$<$X$>$' on page 880 undefined on inp ut line 49807. [880] LaTeX Warning: Hyper reference `Region' on page 881 undefined on input line 498 47. LaTeX Warning: Hyper reference `Circle' on page 881 undefined on input line 498 47. LaTeX Warning: Hyper reference `Interval' on page 881 undefined on input line 4 9847. LaTeX Warning: Hyper reference `astPrism' on page 881 undefined on input line 4 9847. [881] LaTeX Warning: Hyper reference `Mapping' on page 882 undefined on input line 49 890. LaTeX Warning: Hyper reference `astRateMap' on page 882 undefined on input line 49890. [882] LaTeX Warning: Hyper reference `Circle' on page 883 undefined on input line 500 58. LaTeX Warning: Hyper reference `Box' on page 883 undefined on input line 50058. LaTeX Warning: Hyper reference `Frame' on page 883 undefined on input line 5005 8. LaTeX Warning: Hyper reference `astFormat' on page 883 undefined on input line 50058. LaTeX Warning: Hyper reference `Mapping' on page 883 undefined on input line 50 058. LaTeX Warning: Hyper reference `astPointInRegion' on page 883 undefined on inpu t line 50058. LaTeX Warning: Hyper reference `UnitMap' on page 883 undefined on input line 50 058. LaTeX Warning: Hyper reference `astRemoveRegions' on page 883 undefined on inpu t line 50058. LaTeX Warning: Hyper reference `FrameSet' on page 883 undefined on input line 5 0058. LaTeX Warning: Hyper reference `SkyFrame' on page 883 undefined on input line 5 0058. LaTeX Warning: Hyper reference `System' on page 883 undefined on input line 500 58. LaTeX Warning: Hyper reference `astSimplify' on page 883 undefined on input lin e 50058. [883] LaTeX Warning: Hyper reference `Adaptive' on page 884 undefined on input line 5 0058. LaTeX Warning: Hyper reference `Negated' on page 884 undefined on input line 50 058. LaTeX Warning: Hyper reference `Closed' on page 884 undefined on input line 500 58. LaTeX Warning: Hyper reference `MeshSize' on page 884 undefined on input line 5 0058. LaTeX Warning: Hyper reference `FillFactor' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `Bounded' on page 884 undefined on input line 50 058. LaTeX Warning: Hyper reference `Equinox' on page 884 undefined on input line 50 058. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 884 undefined on in put line 50058. LaTeX Warning: Hyper reference `astGetRegionFrame' on page 884 undefined on inp ut line 50058. LaTeX Warning: Hyper reference `astGetRegionFrameSet' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 884 undefined on inpu t line 50058. LaTeX Warning: Hyper reference `astGetRegionPoints' on page 884 undefined on in put line 50058. LaTeX Warning: Hyper reference `astGetUnc' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 884 undefined on inpu t line 50058. LaTeX Warning: Hyper reference `astMapRegion' on page 884 undefined on input li ne 50058. LaTeX Warning: Hyper reference `astNegate' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astOverlap' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astPointInRegion' on page 884 undefined on inpu t line 50058. LaTeX Warning: Hyper reference `astMask$<$X$>$' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astSetUnc' on page 884 undefined on input line 50058. LaTeX Warning: Hyper reference `astShowMesh' on page 884 undefined on input lin e 50058. [884] LaTeX Warning: Hyper reference `Mapping' on page 885 undefined on input line 50 112. LaTeX Warning: Hyper reference `Region' on page 885 undefined on input line 501 12. LaTeX Warning: Hyper reference `Frame' on page 885 undefined on input line 5011 2. LaTeX Warning: Hyper reference `Nin' on page 885 undefined on input line 50112. LaTeX Warning: Hyper reference `UnitMap' on page 885 undefined on input line 50 112. LaTeX Warning: Hyper reference `astSimplify' on page 885 undefined on input lin e 50112. LaTeX Warning: Hyper reference `astSelectorMap' on page 885 undefined on input line 50112. [885] LaTeX Warning: Hyper reference `Mapping' on page 886 undefined on input line 50 142. LaTeX Warning: Hyper reference `astShiftMap' on page 886 undefined on input lin e 50142. [886] LaTeX Warning: Hyper reference `SkyFrame' on page 887 undefined on input line 5 0162. LaTeX Warning: Hyper reference `astWrite' on page 887 undefined on input line 5 0162. LaTeX Warning: Hyper reference `Axis' on page 887 undefined on input line 50162 . [887] LaTeX Warning: Hyper reference `Frame' on page 888 undefined on input line 5026 5. LaTeX Warning: Hyper reference `System' on page 888 undefined on input line 502 65. LaTeX Warning: Hyper reference `Equinox' on page 888 undefined on input line 50 265. LaTeX Warning: Hyper reference `Epoch' on page 888 undefined on input line 5026 5. LaTeX Warning: Hyper reference `SkyRefIs' on page 888 undefined on input line 5 0265. LaTeX Warning: Hyper reference `AlignOffset' on page 888 undefined on input lin e 50265. LaTeX Warning: Hyper reference `astFormat' on page 888 undefined on input line 50265. LaTeX Warning: Hyper reference `astSkyFrame' on page 888 undefined on input lin e 50265. LaTeX Warning: Hyper reference `AlignOffset' on page 888 undefined on input lin e 50265. LaTeX Warning: Hyper reference `AsTime(axis)' on page 888 undefined on input li ne 50265. LaTeX Warning: Hyper reference `Equinox' on page 888 undefined on input line 50 265. LaTeX Warning: Hyper reference `LatAxis' on page 888 undefined on input line 50 265. LaTeX Warning: Hyper reference `LonAxis' on page 888 undefined on input line 50 265. LaTeX Warning: Hyper reference `NegLon' on page 888 undefined on input line 502 65. LaTeX Warning: Hyper reference `Projection' on page 888 undefined on input line 50265. LaTeX Warning: Hyper reference `SkyRefIs' on page 888 undefined on input line 5 0265. LaTeX Warning: Hyper reference `SkyTol' on page 888 undefined on input line 502 65. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 888 undefined on input line 50265. LaTeX Warning: Hyper reference `Mapping' on page 888 undefined on input line 50 265. [888] LaTeX Warning: Hyper reference `Mapping' on page 889 undefined on input line 50 314. LaTeX Warning: Hyper reference `astSlaAdd' on page 889 undefined on input line 50314. LaTeX Warning: Hyper reference `astSlaMap' on page 889 undefined on input line 50314. LaTeX Warning: Hyper reference `astSlaAdd' on page 889 undefined on input line 50314. [889] LaTeX Warning: Hyper reference `SpecFrame' on page 890 undefined on input line 50352. LaTeX Warning: Hyper reference `FluxFrame' on page 890 undefined on input line 50352. LaTeX Warning: Hyper reference `Frame' on page 890 undefined on input line 5035 2. LaTeX Warning: Hyper reference `Plot' on page 890 undefined on input line 50352 . LaTeX Warning: Hyper reference `astSpecFluxFrame' on page 890 undefined on inpu t line 50352. LaTeX Warning: Hyper reference `CmpFrame' on page 890 undefined on input line 5 0352. LaTeX Warning: Hyper reference `StdOfRest' on page 890 undefined on input line 50352. [890] LaTeX Warning: Hyper reference `Frame' on page 891 undefined on input line 5044 0. LaTeX Warning: Hyper reference `System' on page 891 undefined on input line 504 40. LaTeX Warning: Hyper reference `SpecOrigin' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `astSpecFrame' on page 891 undefined on input li ne 50440. LaTeX Warning: Hyper reference `AlignSpecOffset' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `RefDec' on page 891 undefined on input line 504 40. LaTeX Warning: Hyper reference `RefRA' on page 891 undefined on input line 5044 0. LaTeX Warning: Hyper reference `RestFreq' on page 891 undefined on input line 5 0440. LaTeX Warning: Hyper reference `SourceSys' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `SourceVel' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `SourceVRF' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `SpecOrigin' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `StdOfRest' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `Unit(axis)' on page 891 undefined on input line 50440. LaTeX Warning: Hyper reference `Label(axis)' on page 891 undefined on input lin e 50440. LaTeX Warning: Hyper reference `astSetRefPos' on page 891 undefined on input li ne 50440. LaTeX Warning: Hyper reference `astGetRefPos' on page 891 undefined on input li ne 50440. [891] LaTeX Warning: Hyper reference `Mapping' on page 892 undefined on input line 50 501. LaTeX Warning: Hyper reference `astSpecAdd' on page 892 undefined on input line 50501. LaTeX Warning: Hyper reference `astSpecMap' on page 892 undefined on input line 50501. LaTeX Warning: Hyper reference `astSpecAdd' on page 892 undefined on input line 50501. [892] LaTeX Warning: Hyper reference `Mapping' on page 893 undefined on input line 50 546. LaTeX Warning: Hyper reference `astSphMap' on page 893 undefined on input line 50546. LaTeX Warning: Hyper reference `UnitRadius' on page 893 undefined on input line 50546. LaTeX Warning: Hyper reference `PolarLong' on page 893 undefined on input line 50546. [893] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 894 undefined on input line 50601. LaTeX Warning: Hyper reference `StcResourceProfile' on page 894 undefined on in put line 50601. LaTeX Warning: Hyper reference `StcSearchLocation' on page 894 undefined on inp ut line 50601. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 894 undefined on in put line 50601. LaTeX Warning: Hyper reference `Region' on page 894 undefined on input line 506 01. LaTeX Warning: Hyper reference `RegionClass' on page 894 undefined on input lin e 50601. LaTeX Warning: Hyper reference `astGetStcRegion' on page 894 undefined on input line 50601. LaTeX Warning: Hyper reference `astGetStcCoord' on page 894 undefined on input line 50601. LaTeX Warning: Hyper reference `astGetStcNCoord' on page 894 undefined on input line 50601. [894] LaTeX Warning: Hyper reference `Stc' on page 895 undefined on input line 50633. LaTeX Warning: Hyper reference `astStcCatalogEntryLocation' on page 895 undefin ed on input line 50633. [895] LaTeX Warning: Hyper reference `Stc' on page 896 undefined on input line 50684. LaTeX Warning: Hyper reference `Frame' on page 896 undefined on input line 5068 4. LaTeX Warning: Hyper reference `ObsLon' on page 896 undefined on input line 506 84. LaTeX Warning: Hyper reference `ObsLat' on page 896 undefined on input line 506 84. LaTeX Warning: Hyper reference `astStcObsDataLocation' on page 896 undefined on input line 50684. [896] LaTeX Warning: Hyper reference `Stc' on page 897 undefined on input line 50716. LaTeX Warning: Hyper reference `astStcResourceProfile' on page 897 undefined on input line 50716. [897] LaTeX Warning: Hyper reference `Stc' on page 898 undefined on input line 50748. LaTeX Warning: Hyper reference `astStcSearchLocation' on page 898 undefined on input line 50748. [898] LaTeX Warning: Hyper reference `Channel' on page 899 undefined on input line 50 910. LaTeX Warning: Hyper reference `Object' on page 899 undefined on input line 509 10. LaTeX Warning: Hyper reference `astWrite' on page 899 undefined on input line 5 0910. LaTeX Warning: Hyper reference `astRead' on page 899 undefined on input line 50 910. LaTeX Warning: Hyper reference `PointList' on page 899 undefined on input line 50910. LaTeX Warning: Hyper reference `Region' on page 899 undefined on input line 509 10. LaTeX Warning: Hyper reference `KeyMap' on page 899 undefined on input line 509 10. LaTeX Warning: Hyper reference `StcsArea' on page 899 undefined on input line 5 0910. LaTeX Warning: Hyper reference `StcsCoords' on page 899 undefined on input line 50910. LaTeX Warning: Hyper reference `StcsProps' on page 899 undefined on input line 50910. LaTeX Warning: Hyper reference `XmlChan' on page 899 undefined on input line 50 910. LaTeX Warning: Hyper reference `SinkFile' on page 899 undefined on input line 5 0910. LaTeX Warning: Hyper reference `SourceFile' on page 899 undefined on input line 50910. LaTeX Warning: Hyper reference `TimeFrame' on page 899 undefined on input line 50910. LaTeX Warning: Hyper reference `SkyFrame' on page 899 undefined on input line 5 0910. [899] Overfull \hbox (7.12534pt too wide) in paragraph at lines 50910--50910 \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 900 undefined on input lin e 50910. LaTeX Warning: Hyper reference `StcsArea' on page 900 undefined on input line 5 0910. LaTeX Warning: Hyper reference `StcsCoords' on page 900 undefined on input line 50910. LaTeX Warning: Hyper reference `StcsLength' on page 900 undefined on input line 50910. LaTeX Warning: Hyper reference `StcsProps' on page 900 undefined on input line 50910. [900] LaTeX Warning: Hyper reference `Mapping' on page 901 undefined on input line 50 999. LaTeX Warning: Hyper reference `Nin' on page 901 undefined on input line 50999. LaTeX Warning: Hyper reference `Nout' on page 901 undefined on input line 50999 . LaTeX Warning: Hyper reference `SelectorMap' on page 901 undefined on input lin e 50999. LaTeX Warning: Hyper reference `UnitMap' on page 901 undefined on input line 50 999. LaTeX Warning: Hyper reference `astSimplify' on page 901 undefined on input lin e 50999. LaTeX Warning: Hyper reference `astSwitchMap' on page 901 undefined on input li ne 50999. [901] [902] LaTeX Warning: Hyper reference `KeyMap' on page 903 undefined on input line 511 22. LaTeX Warning: Hyper reference `astAddColumn' on page 903 undefined on input li ne 51122. LaTeX Warning: Hyper reference `astAddParameter' on page 903 undefined on input line 51122. LaTeX Warning: Hyper reference `astTable' on page 903 undefined on input line 5 1122. LaTeX Warning: Hyper reference `ColumnLenC(column)' on page 903 undefined on in put line 51122. LaTeX Warning: Hyper reference `ColumnLength(column)' on page 903 undefined on input line 51122. LaTeX Warning: Hyper reference `ColumnNdim(column)' on page 903 undefined on in put line 51122. LaTeX Warning: Hyper reference `ColumnType(column)' on page 903 undefined on in put line 51122. LaTeX Warning: Hyper reference `Ncolumn' on page 903 undefined on input line 51 122. LaTeX Warning: Hyper reference `Nrow' on page 903 undefined on input line 51122 . LaTeX Warning: Hyper reference `Nparameter' on page 903 undefined on input line 51122. LaTeX Warning: Hyper reference `astAddColumn' on page 903 undefined on input li ne 51122. LaTeX Warning: Hyper reference `astAddParameter' on page 903 undefined on input line 51122. LaTeX Warning: Hyper reference `astColumnName' on page 903 undefined on input l ine 51122. LaTeX Warning: Hyper reference `astColumnShape' on page 903 undefined on input line 51122. LaTeX Warning: Hyper reference `astHasColumn' on page 903 undefined on input li ne 51122. [903] LaTeX Warning: Hyper reference `astHasParameter' on page 904 undefined on input line 51122. LaTeX Warning: Hyper reference `astParameterName' on page 904 undefined on inpu t line 51122. LaTeX Warning: Hyper reference `astPurgeRows' on page 904 undefined on input li ne 51122. LaTeX Warning: Hyper reference `astRemoveColumn' on page 904 undefined on input line 51122. LaTeX Warning: Hyper reference `astRemoveParameter' on page 904 undefined on in put line 51122. LaTeX Warning: Hyper reference `astRemoveRow' on page 904 undefined on input li ne 51122. [904] LaTeX Warning: Hyper reference `Frame' on page 905 undefined on input line 5120 6. LaTeX Warning: Hyper reference `System' on page 905 undefined on input line 512 06. LaTeX Warning: Hyper reference `TimeOrigin' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `TimeScale' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `astTimeFrame' on page 905 undefined on input li ne 51206. LaTeX Warning: Hyper reference `AlignTimeScale' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `LTOffset' on page 905 undefined on input line 5 1206. LaTeX Warning: Hyper reference `TimeOrigin' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `TimeScale' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `Unit(axis)' on page 905 undefined on input line 51206. LaTeX Warning: Hyper reference `Label(axis)' on page 905 undefined on input lin e 51206. LaTeX Warning: Hyper reference `astCurrentTime' on page 905 undefined on input line 51206. [905] LaTeX Warning: Hyper reference `Mapping' on page 906 undefined on input line 51 253. LaTeX Warning: Hyper reference `astTimeAdd' on page 906 undefined on input line 51253. LaTeX Warning: Hyper reference `astTimeMap' on page 906 undefined on input line 51253. LaTeX Warning: Hyper reference `astTimeAdd' on page 906 undefined on input line 51253. [906] LaTeX Warning: Hyper reference `Mapping' on page 907 undefined on input line 51 292. LaTeX Warning: Hyper reference `astTranMap' on page 907 undefined on input line 51292. [907] LaTeX Warning: Hyper reference `Mapping' on page 908 undefined on input line 51 326. LaTeX Warning: Hyper reference `Nin' on page 908 undefined on input line 51326. LaTeX Warning: Hyper reference `Nout' on page 908 undefined on input line 51326 . LaTeX Warning: Hyper reference `astUnitMap' on page 908 undefined on input line 51326. [908] LaTeX Warning: Hyper reference `Nin' on page 909 undefined on input line 51383. LaTeX Warning: Hyper reference `astUnitNormMap' on page 909 undefined on input line 51383. LaTeX Warning: Hyper reference `Mapping' on page 909 undefined on input line 51 383. [909] LaTeX Warning: Hyper reference `Mapping' on page 910 undefined on input line 51 472. LaTeX Warning: Hyper reference `WcsType' on page 910 undefined on input line 51 472. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 910 undefined on input line 51472. LaTeX Warning: Hyper reference `PVi_m' on page 910 undefined on input line 5147 2. LaTeX Warning: Hyper reference `astWcsMap' on page 910 undefined on input line 51472. LaTeX Warning: Hyper reference `NatLat' on page 910 undefined on input line 514 72. LaTeX Warning: Hyper reference `NatLon' on page 910 undefined on input line 514 72. LaTeX Warning: Hyper reference `PVi_m' on page 910 undefined on input line 5147 2. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 910 undefined on input line 51472. LaTeX Warning: Hyper reference `WcsType' on page 910 undefined on input line 51 472. [910] [911] LaTeX Warning: Hyper reference `Mapping' on page 912 undefined on input line 51 508. LaTeX Warning: Hyper reference `astWinMap' on page 912 undefined on input line 51508. [912] LaTeX Warning: Hyper reference `Channel' on page 913 undefined on input line 51 565. LaTeX Warning: Hyper reference `Object' on page 913 undefined on input line 515 65. LaTeX Warning: Hyper reference `astWrite' on page 913 undefined on input line 5 1565. LaTeX Warning: Hyper reference `SinkFile' on page 913 undefined on input line 5 1565. LaTeX Warning: Hyper reference `SourceFile' on page 913 undefined on input line 51565. LaTeX Warning: Hyper reference `astXmlChan' on page 913 undefined on input line 51565. LaTeX Warning: Hyper reference `XmlFormat' on page 913 undefined on input line 51565. LaTeX Warning: Hyper reference `System' on page 913 undefined on input line 515 65. LaTeX Warning: Hyper reference `XmlLength' on page 913 undefined on input line 51565. LaTeX Warning: Hyper reference `XmlPrefix' on page 913 undefined on input line 51565. [913] LaTeX Warning: Hyper reference `Channel' on page 914 undefined on input line 51 639. LaTeX Warning: Hyper reference `Object' on page 914 undefined on input line 516 39. LaTeX Warning: Hyper reference `astWrite' on page 914 undefined on input line 5 1639. LaTeX Warning: Hyper reference `YamlEncoding' on page 914 undefined on input li ne 51639. LaTeX Warning: Hyper reference `SinkFile' on page 914 undefined on input line 5 1639. LaTeX Warning: Hyper reference `SourceFile' on page 914 undefined on input line 51639. LaTeX Warning: Hyper reference `astYamlChan' on page 914 undefined on input lin e 51639. LaTeX Warning: Hyper reference `VerboseRead' on page 914 undefined on input lin e 51639. LaTeX Warning: Hyper reference `PreserveName' on page 914 undefined on input li ne 51639. LaTeX Warning: Hyper reference `Ident' on page 914 undefined on input line 5163 9. LaTeX Warning: Hyper reference `YamlEncoding' on page 914 undefined on input li ne 51639. [914] LaTeX Warning: Hyper reference `Mapping' on page 915 undefined on input line 51 678. LaTeX Warning: Hyper reference `astZoomMap' on page 915 undefined on input line 51678. LaTeX Warning: Hyper reference `Zoom' on page 915 undefined on input line 51678 . [915] [916] [917] Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 LaTeX Warning: Hyper reference `System' on page 918 undefined on input line 518 68. [918] [919] [920] LaTeX Warning: Hyper reference `ast_link' on page 921 undefined on input line 5 2033. Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 [921] LaTeX Warning: Hyper reference `System' on page 922 undefined on input line 520 33. [922] LaTeX Warning: Hyper reference `astMalloc' on page 923 undefined on input line 52040. LaTeX Warning: Hyper reference `astFree' on page 923 undefined on input line 52 041. LaTeX Warning: Hyper reference `astRealloc' on page 923 undefined on input line 52041. LaTeX Warning: Hyper reference `astStore' on page 923 undefined on input line 5 2053. LaTeX Warning: Hyper reference `astGrow' on page 923 undefined on input line 52 056. LaTeX Warning: Hyper reference `astAppendString' on page 923 undefined on input line 52057. [923] Overfull \hbox (5.62103pt too wide) in paragraph at lines 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 [] \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 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 []\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 52155--52155 \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 924 undefined on input line 52 155. Overfull \hbox (28.50703pt too wide) in paragraph at lines 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 [][]\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 52155--52155 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [924] LaTeX Warning: Hyper reference `astAppendString' on page 925 undefined on input line 52231. Overfull \hbox (5.62103pt too wide) in paragraph at lines 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 [] \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 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 []\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 52231--52231 \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 52231--52231 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (15.85603pt too wide) in paragraph at lines 52231--52231 [] \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 52231--52231 \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 52231--52231 LaTeX Warning: Hyper reference `astFree' on page 925 undefined on input line 52 231. Overfull \hbox (28.50703pt too wide) in paragraph at lines 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 [][]\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 52231--52231 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [925] Overfull \hbox (21.10757pt too wide) in paragraph at lines 52352--52352 []\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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 926 undefined on input line 52 352. Overfull \hbox (21.10475pt too wide) in paragraph at lines 52352--52352 \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 52352--52352 \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 52352--52352 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.10475pt too wide) in paragraph at lines 52352--52352 [] \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [926] Overfull \hbox (7.51216pt too wide) in paragraph at lines 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 [][]\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 52352--52352 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [927] LaTeX Warning: Hyper reference `astMalloc' on page 928 undefined on input line 52400. Overfull \hbox (2.26344pt too wide) in paragraph at lines 52400--52400 \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 52400--52400 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [928] Overfull \hbox (21.10475pt too wide) in paragraph at lines 52436--52436 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [929] LaTeX Warning: Hyper reference `astStringCase' on page 930 undefined on input l ine 52480. Overfull \hbox (42.36206pt too wide) in paragraph at lines 52480--52480 [] \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [930] [931] Overfull \hbox (10.13652pt too wide) in paragraph at lines 52531--52531 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [932] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52572--52572 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [933] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52618--52618 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [934] LaTeX Warning: Hyper reference `astChrClean' on page 935 undefined on input lin e 52639. [935] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52683--52683 \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 52683--52683 \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 52683--52683 \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 52683--52683 [][]\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 52683--52683 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [936] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52737--52737 \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 52737--52737 \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 52737--52737 [][]\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 52737--52737 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [937] Overfull \hbox (35.49646pt too wide) in paragraph at lines 52811--52811 []\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 938 undefined on input line 52811. Overfull \hbox (23.72911pt too wide) in paragraph at lines 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 938 undefined on input line 52 811. Overfull \hbox (7.72334pt too wide) in paragraph at lines 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 [][]\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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 [][]\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 52811--52811 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [938] Overfull \hbox (13.86804pt too wide) in paragraph at lines 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 939 undefined on input line 52 946. Overfull \hbox (10.13652pt too wide) in paragraph at lines 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 [][]\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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [939] Overfull \hbox (13.02332pt too wide) in paragraph at lines 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 []\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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [940] [941] Overfull \hbox (1.84724pt too wide) in paragraph at lines 53022--53022 []\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 53022--53022 \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 53022--53022 \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 53022--53022 \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 53022--53022 [] \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 53022--53022 [] \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 53022--53022 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [942] Overfull \hbox (10.86975pt too wide) in paragraph at lines 53053--53053 [] \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 53053--53053 \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 53053--53053 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [943] LaTeX Warning: Hyper reference `astGrow' on page 944 undefined on input line 53 091. Overfull \hbox (10.86975pt too wide) in paragraph at lines 53091--53091 [] \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 53091--53091 \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 53091--53091 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [944] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53154--53154 [] \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 53154--53154 \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 53154--53154 [][]\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 53154--53154 \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 53154--53154 \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 53154--53154 [][]\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 53154--53154 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [945] Overfull \hbox (7.7746pt too wide) in paragraph at lines 53195--53195 \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 53195--53195 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [946] Overfull \hbox (2.26344pt too wide) in paragraph at lines 53236--53236 \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 53236--53236 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [947] LaTeX Warning: Hyper reference `astTune' on page 948 undefined on input line 53 272. Overfull \hbox (12.18193pt too wide) in paragraph at lines 53272--53272 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see astTu ne in objectc.c). [948] Overfull \hbox (42.36206pt too wide) in paragraph at lines 53329--53329 [] \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 53329--53329 \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 53329--53329 \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 53329--53329 \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 53329--53329 [][]\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 53329--53329 \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 53329--53329 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [949] [950] Overfull \hbox (0.37231pt too wide) in paragraph at lines 53386--53386 [] \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 53386--53386 \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 53386--53386 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [951] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53450--53450 [] \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 952 undefined on input line 53450. Overfull \hbox (26.6159pt too wide) in paragraph at lines 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 [][]\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 53450--53450 \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 53450--53450 \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 53450--53450 [][]\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 53450--53450 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [952] LaTeX Warning: Hyper reference `astFree' on page 953 undefined on input line 53 502. Overfull \hbox (4.1005pt too wide) in paragraph at lines 53502--53502 \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 53502--53502 \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 53502--53502 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [953] LaTeX Warning: Hyper reference `astFree' on page 954 undefined on input line 53 574. Overfull \hbox (21.10475pt too wide) in paragraph at lines 53574--53574 \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 53574--53574 \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 53574--53574 \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 53574--53574 \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 53574--53574 []\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 53574--53574 \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 53574--53574 [][]\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 53574--53574 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [954] LaTeX Warning: Hyper reference `astChrCase' on page 955 undefined on input line 53619. Overfull \hbox (5.62103pt too wide) in paragraph at lines 53619--53619 \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 955 undefined on input line 53 619. Overfull \hbox (4.1005pt too wide) in paragraph at lines 53619--53619 \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 53619--53619 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [955] LaTeX Warning: Hyper reference `FitsChan' on page 956 undefined on input line 5 3625. LaTeX Warning: Hyper reference `Encoding' on page 956 undefined on input line 5 3629. LaTeX Warning: Hyper reference `FrameSet' on page 956 undefined on input line 5 3631. LaTeX Warning: Hyper reference `astRead' on page 956 undefined on input line 53 633. LaTeX Warning: Hyper reference `astWrite' on page 956 undefined on input line 5 3637. LaTeX Warning: Hyper reference `Frame' on page 956 undefined on input line 5363 8. LaTeX Warning: Hyper reference `MathMap' on page 956 undefined on input line 53 639. LaTeX Warning: Hyper reference `FrameSet' on page 956 undefined on input line 5 3652. LaTeX Warning: Hyper reference `FitsChan' on page 956 undefined on input line 5 3652. LaTeX Warning: Hyper reference `Frame' on page 956 undefined on input line 5365 6. LaTeX Warning: Hyper reference `SkyFrame' on page 956 undefined on input line 5 3657. LaTeX Warning: Hyper reference `SpecFrame' on page 956 undefined on input line 53657. LaTeX Warning: Hyper reference `Table' on page 956 undefined on input line 5365 9. LaTeX Warning: Reference `tab:fitspaper1' on page 956 undefined on input line 5 3659. LaTeX Warning: Hyper reference `Mapping' on page 956 undefined on input line 53 673. LaTeX Warning: Hyper reference `CDMatrix' on page 956 undefined on input line 5 3680. Underfull \hbox (badness 1490) in paragraph at lines 53688--53688 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, LaTeX Warning: Hyper reference `Domain' on page 956 undefined on input line 537 11. Overfull \hbox (7.69725pt too wide) in paragraph at lines 53663--53720 [][] LaTeX Warning: Hyper reference `FrameSet' on page 956 undefined on input line 5 3725. LaTeX Warning: Hyper reference `Frame' on page 956 undefined on input line 5372 6. LaTeX Warning: Hyper reference `FitsChan' on page 956 undefined on input line 5 3726. LaTeX Warning: Hyper reference `Mapping' on page 956 undefined on input line 53 727. LaTeX Warning: Hyper reference `FrameSet' on page 956 undefined on input line 5 3732. LaTeX Warning: Hyper reference `FitsChan' on page 956 undefined on input line 5 3732. LaTeX Warning: Hyper reference `Frame' on page 956 undefined on input line 5373 3. LaTeX Warning: Hyper reference `SkyFrame' on page 956 undefined on input line 5 3747. LaTeX Warning: Hyper reference `SpecFrame' on page 956 undefined on input line 53747. LaTeX Warning: Hyper reference `System' on page 956 undefined on input line 537 48. LaTeX Warning: Hyper reference `Mapping' on page 956 undefined on input line 53 749. [956] [957] LaTeX Warning: Hyper reference `FrameSet' on page 958 undefined on input line 5 3753. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3754. LaTeX Warning: Hyper reference `Frame' on page 958 undefined on input line 5376 2. LaTeX Warning: Hyper reference `Mapping' on page 958 undefined on input line 53 773. LaTeX Warning: Hyper reference `SkyFrame' on page 958 undefined on input line 5 3777. LaTeX Warning: Hyper reference `SpecFrame' on page 958 undefined on input line 53777. LaTeX Warning: Hyper reference `FrameSet' on page 958 undefined on input line 5 3782. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3783. LaTeX Warning: Hyper reference `Frame' on page 958 undefined on input line 5378 4. LaTeX Warning: Hyper reference `FrameSet' on page 958 undefined on input line 5 3793. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3794. LaTeX Warning: Hyper reference `Frame' on page 958 undefined on input line 5379 5. LaTeX Warning: Hyper reference `Mapping' on page 958 undefined on input line 53 797. LaTeX Warning: Hyper reference `Ident' on page 958 undefined on input line 5379 7. [958] LaTeX Warning: Hyper reference `FrameSet' on page 959 undefined on input line 5 3817. LaTeX Warning: Hyper reference `FitsChan' on page 959 undefined on input line 5 3818. LaTeX Warning: Hyper reference `Frame' on page 959 undefined on input line 5381 9. LaTeX Warning: Hyper reference `SkyFrame' on page 959 undefined on input line 5 3820. LaTeX Warning: Hyper reference `Table' on page 959 undefined on input line 5382 2. LaTeX Warning: Reference `tab:fitspaper2' on page 959 undefined on input line 5 3822. LaTeX Warning: Hyper reference `System' on page 959 undefined on input line 538 36. LaTeX Warning: Hyper reference `WcsType' on page 959 undefined on input line 53 836. LaTeX Warning: Hyper reference `WcsMap' on page 959 undefined on input line 538 36. LaTeX Warning: Hyper reference `Mapping' on page 959 undefined on input line 53 842. LaTeX Warning: Hyper reference `PVi_m' on page 959 undefined on input line 5384 7. Underfull \hbox (badness 2103) in paragraph at lines 53857--53857 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the LaTeX Warning: Hyper reference `Equinox' on page 959 undefined on input line 53 861. Underfull \hbox (badness 4291) in paragraph at lines 53865--53866 []|\T1/ppl/m/n/10.95 (+20) Only writ-ten if us-ing FITS-AIPS LaTeX Warning: Hyper reference `Epoch' on page 959 undefined on input line 5387 2. Overfull \hbox (1.56534pt too wide) in paragraph at lines 53826--53877 [][] LaTeX Warning: Hyper reference `FrameSet' on page 959 undefined on input line 5 3882. LaTeX Warning: Hyper reference `Frame' on page 959 undefined on input line 5388 3. LaTeX Warning: Hyper reference `SkyFrame' on page 959 undefined on input line 5 3883. LaTeX Warning: Hyper reference `FitsChan' on page 959 undefined on input line 5 3884. LaTeX Warning: Hyper reference `Mapping' on page 959 undefined on input line 53 888. LaTeX Warning: Hyper reference `WcsMap' on page 959 undefined on input line 538 89. LaTeX Warning: Hyper reference `TabOK' on page 959 undefined on input line 5389 4. LaTeX Warning: Hyper reference `FrameSet' on page 959 undefined on input line 5 3904. LaTeX Warning: Hyper reference `FitsChan' on page 959 undefined on input line 5 3904. LaTeX Warning: Hyper reference `WcsMap' on page 959 undefined on input line 539 09. [959] [960] LaTeX Warning: Hyper reference `Mapping' on page 961 undefined on input line 53 935. LaTeX Warning: Hyper reference `FrameSet' on page 961 undefined on input line 5 3940. LaTeX Warning: Hyper reference `FitsChan' on page 961 undefined on input line 5 3940. LaTeX Warning: Hyper reference `WcsMap' on page 961 undefined on input line 539 44. LaTeX Warning: Hyper reference `PVi_m' on page 961 undefined on input line 5394 7. LaTeX Warning: Hyper reference `FrameSet' on page 961 undefined on input line 5 3960. LaTeX Warning: Hyper reference `FitsChan' on page 961 undefined on input line 5 3960. LaTeX Warning: Hyper reference `WcsMap' on page 961 undefined on input line 539 77. LaTeX Warning: Hyper reference `Projection' on page 961 undefined on input line 53978. LaTeX Warning: Hyper reference `PVi_m' on page 961 undefined on input line 5397 9. LaTeX Warning: Hyper reference `Warnings' on page 961 undefined on input line 5 3992. [961] LaTeX Warning: Hyper reference `PolyTan' on page 962 undefined on input line 54 003. LaTeX Warning: Hyper reference `FrameSet' on page 962 undefined on input line 5 4009. LaTeX Warning: Hyper reference `FitsChan' on page 962 undefined on input line 5 4010. LaTeX Warning: Hyper reference `Frame' on page 962 undefined on input line 5401 2. LaTeX Warning: Hyper reference `SpecFrame' on page 962 undefined on input line 54012. LaTeX Warning: Hyper reference `Table' on page 962 undefined on input line 5401 4. LaTeX Warning: Reference `tab:fitspaper3' on page 962 undefined on input line 5 4014. LaTeX Warning: Hyper reference `TabOK' on page 962 undefined on input line 5402 9. LaTeX Warning: Hyper reference `System' on page 962 undefined on input line 540 29. LaTeX Warning: Hyper reference `Mapping' on page 962 undefined on input line 54 029. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 962 undefined on inpu t line 54033. Underfull \hbox (badness 4713) in paragraph at lines 54033--54033 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the LaTeX Warning: Hyper reference `GrismMap' on page 962 undefined on input line 5 4037. LaTeX Warning: Hyper reference `StdOfRest' on page 962 undefined on input line 54042. Underfull \hbox (badness 3229) in paragraph at lines 54042--54043 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the LaTeX Warning: Hyper reference `ObsLon' on page 962 undefined on input line 540 50. LaTeX Warning: Hyper reference `ObsLat' on page 962 undefined on input line 540 50. LaTeX Warning: Hyper reference `Epoch' on page 962 undefined on input line 5405 4. Underfull \hbox (badness 2261) in paragraph at lines 54054--54054 []|\T1/ppl/m/n/9 (+20) Used to set the Epoch at-tributes of the LaTeX Warning: Hyper reference `SourceVRF' on page 962 undefined on input line 54059. Underfull \hbox (badness 1931) in paragraph at lines 54059--54060 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the LaTeX Warning: Hyper reference `SourceVel' on page 962 undefined on input line 54068. Underfull \hbox (badness 3657) in paragraph at lines 54068--54069 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the LaTeX Warning: Hyper reference `RestFreq' on page 962 undefined on input line 5 4077. Underfull \hbox (badness 1043) in paragraph at lines 54077--54077 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 54077--54078 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 54083--54083 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 54083--54084 []|\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 54019--54092 [][] LaTeX Warning: Hyper reference `FrameSet' on page 962 undefined on input line 5 4097. LaTeX Warning: Hyper reference `Frame' on page 962 undefined on input line 5409 7. LaTeX Warning: Hyper reference `SpecFrame' on page 962 undefined on input line 54097. LaTeX Warning: Hyper reference `FitsChan' on page 962 undefined on input line 5 4098. LaTeX Warning: Hyper reference `Mapping' on page 962 undefined on input line 54 099. LaTeX Warning: Hyper reference `GrismMap' on page 962 undefined on input line 5 4107. LaTeX Warning: Hyper reference `TabOK' on page 962 undefined on input line 5411 1. LaTeX Warning: Hyper reference `FitsChan' on page 962 undefined on input line 5 4126. [962] [963] LaTeX Warning: Hyper reference `FrameSet' on page 964 undefined on input line 5 4141. LaTeX Warning: Hyper reference `FitsChan' on page 964 undefined on input line 5 4141. LaTeX Warning: Hyper reference `Mapping' on page 964 undefined on input line 54 143. LaTeX Warning: Hyper reference `FrameSet' on page 964 undefined on input line 5 4165. LaTeX Warning: Hyper reference `FitsChan' on page 964 undefined on input line 5 4165. LaTeX Warning: Hyper reference `PolyMap' on page 964 undefined on input line 54 170. [964] LaTeX Warning: Reference `ss:howto' on page 965 undefined on input line 54190. LaTeX Warning: Hyper reference `astUnformat' on page 965 undefined on input lin e 54194. LaTeX Warning: Hyper reference `Frame' on page 965 undefined on input line 5419 5. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 965 undefined on i nput line 54196. LaTeX Warning: Hyper reference `astFormat' on page 965 undefined on input line 54197. LaTeX Warning: Reference `ss:unformattingskyaxisvalues' on page 965 undefined o n input line 54200. LaTeX Warning: Hyper reference `SkyFrame' on page 965 undefined on input line 5 4203. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 965 undefined on input line 54207. LaTeX Warning: Hyper reference `astMapBox' on page 965 undefined on input line 54212. LaTeX Warning: Hyper reference `Mapping' on page 965 undefined on input line 54 214. LaTeX Warning: Hyper reference `Object' on page 965 undefined on input line 542 18. LaTeX Warning: Hyper reference `IntraMap' on page 965 undefined on input line 5 4218. LaTeX Warning: Reference `ss:intramaps' on page 965 undefined on input line 542 19. LaTeX Warning: Hyper reference `FrameSet' on page 965 undefined on input line 5 4225. LaTeX Warning: Reference `ss:framesetintegrity' on page 965 undefined on input line 54230. LaTeX Warning: Hyper reference `astSimplify' on page 965 undefined on input lin e 54240. LaTeX Warning: Hyper reference `Channel' on page 965 undefined on input line 54 243. [965] LaTeX Warning: Hyper reference `astRead' on page 966 undefined on input line 54 251. LaTeX Warning: Hyper reference `MatrixMap' on page 966 undefined on input line 54258. LaTeX Warning: Hyper reference `Invert' on page 966 undefined on input line 542 59. LaTeX Warning: Hyper reference `astPolyCurve' on page 966 undefined on input li ne 54275. LaTeX Warning: Reference `ss:plottinggeodesics' on page 966 undefined on input line 54277. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 966 undefined on in put line 54279. LaTeX Warning: Hyper reference `Mapping' on page 966 undefined on input line 54 282. LaTeX Warning: Hyper reference `ast_link' on page 966 undefined on input line 5 4285. LaTeX Warning: Hyper reference `ast_link_adam' on page 966 undefined on input l ine 54286. LaTeX Warning: Hyper reference `astMapBox' on page 966 undefined on input line 54291. LaTeX Warning: Hyper reference `Encoding' on page 966 undefined on input line 5 4296. LaTeX Warning: Hyper reference `FitsChan' on page 966 undefined on input line 5 4296. LaTeX Warning: Hyper reference `FrameSet' on page 966 undefined on input line 5 4301. LaTeX Warning: Hyper reference `Frame' on page 966 undefined on input line 5430 2. LaTeX Warning: Hyper reference `Domain' on page 966 undefined on input line 543 03. LaTeX Warning: Reference `ss:domainconventions' on page 966 undefined on input line 54306. LaTeX Warning: Hyper reference `astFindFits' on page 966 undefined on input lin e 54309. LaTeX Warning: Hyper reference `astPutFits' on page 966 undefined on input line 54311. [966] LaTeX Warning: Hyper reference `astSimplify' on page 967 undefined on input lin e 54322. LaTeX Warning: Hyper reference `UnitRadius' on page 967 undefined on input line 54324. LaTeX Warning: Hyper reference `SphMap' on page 967 undefined on input line 543 24. LaTeX Warning: Hyper reference `MatrixMap' on page 967 undefined on input line 54329. LaTeX Warning: Hyper reference `astConvert' on page 967 undefined on input line 54338. LaTeX Warning: Hyper reference `CmpFrame' on page 967 undefined on input line 5 4339. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 967 undefined on in put line 54350. LaTeX Warning: Hyper reference `Mapping' on page 967 undefined on input line 54 353. LaTeX Warning: Hyper reference `PcdMap' on page 967 undefined on input line 543 55. LaTeX Warning: Hyper reference `FitsChan' on page 967 undefined on input line 5 4359. [967] LaTeX Warning: Hyper reference `MathMap' on page 968 undefined on input line 54 402. LaTeX Warning: Hyper reference `Mapping' on page 968 undefined on input line 54 403. LaTeX Warning: Hyper reference `IntraMap' on page 968 undefined on input line 5 4408. LaTeX Warning: Hyper reference `astIntraReg' on page 968 undefined on input lin e 54408. LaTeX Warning: Hyper reference `IntraFlag' on page 968 undefined on input line 54417. LaTeX Warning: Reference `ss:intraflag' on page 968 undefined on input line 544 20. LaTeX Warning: Hyper reference `Plot' on page 968 undefined on input line 54422 . LaTeX Warning: Hyper reference `Labelling' on page 968 undefined on input line 54431. LaTeX Warning: Hyper reference `FitsChan' on page 968 undefined on input line 5 4433. LaTeX Warning: Hyper reference `Encoding' on page 968 undefined on input line 5 4436. LaTeX Warning: Hyper reference `System' on page 968 undefined on input line 544 39. LaTeX Warning: Hyper reference `SkyFrame' on page 968 undefined on input line 5 4445. [968] LaTeX Warning: Hyper reference `FitsChan' on page 969 undefined on input line 5 4473. LaTeX Warning: Hyper reference `Projection' on page 969 undefined on input line 54488. LaTeX Warning: Hyper reference `PVi_m' on page 969 undefined on input line 5448 9. [969] LaTeX Warning: Hyper reference `Encoding' on page 970 undefined on input line 5 4521. LaTeX Warning: Hyper reference `FrameSet' on page 970 undefined on input line 5 4531. LaTeX Warning: Hyper reference `Object' on page 970 undefined on input line 545 37. LaTeX Warning: Hyper reference `Frame' on page 970 undefined on input line 5453 8. LaTeX Warning: Hyper reference `Warnings' on page 970 undefined on input line 5 4544. LaTeX Warning: Hyper reference `WcsMap' on page 970 undefined on input line 545 50. LaTeX Warning: Hyper reference `astTranN' on page 970 undefined on input line 5 4574. LaTeX Warning: Hyper reference `astMark' on page 970 undefined on input line 54 574. LaTeX Warning: Hyper reference `astPolyCurve' on page 970 undefined on input li ne 54575. LaTeX Warning: Hyper reference `Plot' on page 970 undefined on input line 54580 . [970] LaTeX Warning: Hyper reference `FitsChan' on page 971 undefined on input line 5 4586. LaTeX Warning: Hyper reference `FrameSet' on page 971 undefined on input line 5 4587. LaTeX Warning: Hyper reference `Domain' on page 971 undefined on input line 545 88. LaTeX Warning: Hyper reference `Frame' on page 971 undefined on input line 5459 0. LaTeX Warning: Hyper reference `Ident' on page 971 undefined on input line 5459 6. LaTeX Warning: Hyper reference `SkyFrame' on page 971 undefined on input line 5 4602. LaTeX Warning: Hyper reference `System' on page 971 undefined on input line 546 02. LaTeX Warning: Hyper reference `Warnings' on page 971 undefined on input line 5 4613. LaTeX Warning: Hyper reference `AllWarnings' on page 971 undefined on input lin e 54617. LaTeX Warning: Hyper reference `Title' on page 971 undefined on input line 5462 1. [971] LaTeX Warning: Hyper reference `LatAxis' on page 972 undefined on input line 54 641. LaTeX Warning: Hyper reference `LonAxis' on page 972 undefined on input line 54 641. LaTeX Warning: Hyper reference `Object' on page 972 undefined on input line 546 44. LaTeX Warning: Hyper reference `ID' on page 972 undefined on input line 54645. LaTeX Warning: Hyper reference `Mapping' on page 972 undefined on input line 54 650. LaTeX Warning: Hyper reference `CmpFrame' on page 972 undefined on input line 5 4650. LaTeX Warning: Hyper reference `Frame' on page 972 undefined on input line 5466 1. LaTeX Warning: Hyper reference `astAngle' on page 972 undefined on input line 5 4662. LaTeX Warning: Hyper reference `astOffset2' on page 972 undefined on input line 54667. LaTeX Warning: Hyper reference `astAxDistance' on page 972 undefined on input l ine 54674. LaTeX Warning: Hyper reference `astAxOffset' on page 972 undefined on input lin e 54680. LaTeX Warning: Hyper reference `Plot' on page 972 undefined on input line 54686 . LaTeX Warning: Hyper reference `astGenCurve' on page 972 undefined on input lin e 54687. LaTeX Warning: Hyper reference `Mapping' on page 972 undefined on input line 54 689. LaTeX Warning: Hyper reference `astGrfSet' on page 972 undefined on input line 54695. LaTeX Warning: Hyper reference `ast_link' on page 972 undefined on input line 5 4699. LaTeX Warning: Hyper reference `astGrfPush' on page 972 undefined on input line 54702. LaTeX Warning: Hyper reference `astGrfPop' on page 972 undefined on input line 54702. [972] LaTeX Warning: Hyper reference `IntraMap' on page 973 undefined on input line 5 4715. LaTeX Warning: Hyper reference `FitsChan' on page 973 undefined on input line 5 4718. LaTeX Warning: Hyper reference `SkyFrame' on page 973 undefined on input line 5 4736. LaTeX Warning: Hyper reference `NegLon' on page 973 undefined on input line 547 36. LaTeX Warning: Hyper reference `astAngle' on page 973 undefined on input line 5 4741. LaTeX Warning: Hyper reference `astAxAngle' on page 973 undefined on input line 54741. LaTeX Warning: Hyper reference `astResolve' on page 973 undefined on input line 54741. LaTeX Warning: Hyper reference `astOffset2' on page 973 undefined on input line 54741. LaTeX Warning: Hyper reference `astAxOffset' on page 973 undefined on input lin e 54741. LaTeX Warning: Hyper reference `astAxDistance' on page 973 undefined on input l ine 54742. LaTeX Warning: Hyper reference `Frame' on page 973 undefined on input line 5474 3. LaTeX Warning: Hyper reference `astDecompose' on page 973 undefined on input li ne 54763. LaTeX Warning: Hyper reference `Mapping' on page 973 undefined on input line 54 763. LaTeX Warning: Hyper reference `CmpMap' on page 973 undefined on input line 547 64. LaTeX Warning: Hyper reference `CmpFrame' on page 973 undefined on input line 5 4765. LaTeX Warning: Hyper reference `FitsChan' on page 973 undefined on input line 5 4780. LaTeX Warning: Hyper reference `DefB1950' on page 973 undefined on input line 5 4780. LaTeX Warning: Hyper reference `astWrite' on page 973 undefined on input line 5 4786. LaTeX Warning: Hyper reference `FrameSet' on page 973 undefined on input line 5 4787. [973] LaTeX Warning: Hyper reference `astRead' on page 974 undefined on input line 54 790. LaTeX Warning: Hyper reference `Plot' on page 974 undefined on input line 54802 . LaTeX Warning: Hyper reference `Grid' on page 974 undefined on input line 54806 . LaTeX Warning: Hyper reference `CarLin' on page 974 undefined on input line 548 19. LaTeX Warning: Hyper reference `FitsChan' on page 974 undefined on input line 5 4819. LaTeX Warning: Hyper reference `FrameSet' on page 974 undefined on input line 5 4821. LaTeX Warning: Hyper reference `Mapping' on page 974 undefined on input line 54 825. LaTeX Warning: Hyper reference `astRead' on page 974 undefined on input line 54 828. LaTeX Warning: Hyper reference `Plot' on page 974 undefined on input line 54835 . LaTeX Warning: Hyper reference `astSet' on page 974 undefined on input line 548 44. [974] LaTeX Warning: Hyper reference `FitsChan' on page 975 undefined on input line 5 4856. LaTeX Warning: Hyper reference `FrameSet' on page 975 undefined on input line 5 4857. LaTeX Warning: Hyper reference `astBoundingBox' on page 975 undefined on input line 54864. LaTeX Warning: Hyper reference `Plot' on page 975 undefined on input line 54865 . LaTeX Warning: Hyper reference `Invisible' on page 975 undefined on input line 54868. LaTeX Warning: Hyper reference `FitsChan' on page 975 undefined on input line 5 4891. LaTeX Warning: Hyper reference `astWrite' on page 975 undefined on input line 5 4892. LaTeX Warning: Hyper reference `WcsMap' on page 975 undefined on input line 549 16. [975] LaTeX Warning: Hyper reference `Frame' on page 976 undefined on input line 5492 7. LaTeX Warning: Hyper reference `Top(axis)' on page 976 undefined on input line 54927. LaTeX Warning: Hyper reference `Bottom(axis)' on page 976 undefined on input li ne 54927. LaTeX Warning: Hyper reference `astGrid' on page 976 undefined on input line 54 929. LaTeX Warning: Hyper reference `Frame' on page 976 undefined on input line 5493 5. LaTeX Warning: Hyper reference `Channel' on page 976 undefined on input line 54 939. LaTeX Warning: Hyper reference `FitsChan' on page 976 undefined on input line 5 4940. LaTeX Warning: Hyper reference `Encoding' on page 976 undefined on input line 5 4940. LaTeX Warning: Hyper reference `astShow' on page 976 undefined on input line 54 941. LaTeX Warning: Hyper reference `Domain' on page 976 undefined on input line 549 53. LaTeX Warning: Hyper reference `CmpFrame' on page 976 undefined on input line 5 4953. LaTeX Warning: Hyper reference `astWrite' on page 976 undefined on input line 5 4960. LaTeX Warning: Hyper reference `FrameSet' on page 976 undefined on input line 5 4962. LaTeX Warning: Hyper reference `Current' on page 976 undefined on input line 54 963. LaTeX Warning: Hyper reference `Base' on page 976 undefined on input line 54964 . LaTeX Warning: Hyper reference `SpecFrame' on page 976 undefined on input line 54979. LaTeX Warning: Hyper reference `SpecMap' on page 976 undefined on input line 54 979. LaTeX Warning: Hyper reference `Mapping' on page 976 undefined on input line 54 984. [976] LaTeX Warning: Hyper reference `astConvert' on page 977 undefined on input line 54996. LaTeX Warning: Hyper reference `Axis' on page 977 undefined on input line 54997 . LaTeX Warning: Hyper reference `ZoomMap' on page 977 undefined on input line 54 999. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 977 undefined on inpu t line 55007. LaTeX Warning: Hyper reference `System' on page 977 undefined on input line 550 13. LaTeX Warning: Hyper reference `Epoch' on page 977 undefined on input line 5501 3. LaTeX Warning: Hyper reference `SkyFrame' on page 977 undefined on input line 5 5013. LaTeX Warning: Hyper reference `AlignSystem' on page 977 undefined on input lin e 55018. LaTeX Warning: Hyper reference `astFindFrame' on page 977 undefined on input li ne 55020. LaTeX Warning: Hyper reference `StdOfRest' on page 977 undefined on input line 55027. LaTeX Warning: Hyper reference `Equinox' on page 977 undefined on input line 55 028. LaTeX Warning: Hyper reference `Plot' on page 977 undefined on input line 55039 . [977] LaTeX Warning: Hyper reference `astVersion' on page 978 undefined on input line 55051. LaTeX Warning: Hyper reference `FitsChan' on page 978 undefined on input line 5 5071. LaTeX Warning: Hyper reference `CDMatrix' on page 978 undefined on input line 5 5080. LaTeX Warning: Hyper reference `FrameSet' on page 978 undefined on input line 5 5081. LaTeX Warning: Hyper reference `SkyFrame' on page 978 undefined on input line 5 5105. LaTeX Warning: Hyper reference `System' on page 978 undefined on input line 551 05. LaTeX Warning: Hyper reference `PolyMap' on page 978 undefined on input line 55 122. [978] LaTeX Warning: Hyper reference `Warnings' on page 979 undefined on input line 5 5128. LaTeX Warning: Hyper reference `Encoding' on page 979 undefined on input line 5 5141. LaTeX Warning: Hyper reference `DefB1950' on page 979 undefined on input line 5 5148. LaTeX Warning: Hyper reference `astRate' on page 979 undefined on input line 55 161. LaTeX Warning: Hyper reference `Mapping' on page 979 undefined on input line 55 163. LaTeX Warning: Hyper reference `Frame' on page 979 undefined on input line 5516 7. LaTeX Warning: Hyper reference `Domain' on page 979 undefined on input line 551 67. LaTeX Warning: Hyper reference `CmpFrame' on page 979 undefined on input line 5 5171. LaTeX Warning: Hyper reference `GrismMap' on page 979 undefined on input line 5 5178. [979] LaTeX Warning: Hyper reference `ShiftMap' on page 980 undefined on input line 5 5181. LaTeX Warning: Hyper reference `WinMap' on page 980 undefined on input line 551 82. LaTeX Warning: Hyper reference `Plot' on page 980 undefined on input line 55185 . LaTeX Warning: Hyper reference `SphMap' on page 980 undefined on input line 551 88. LaTeX Warning: Hyper reference `PolarLong' on page 980 undefined on input line 55188. LaTeX Warning: Hyper reference `WcsMap' on page 980 undefined on input line 551 92. LaTeX Warning: Hyper reference `NatLat' on page 980 undefined on input line 551 95. LaTeX Warning: Hyper reference `NatLon' on page 980 undefined on input line 551 95. LaTeX Warning: Hyper reference `astSimplify' on page 980 undefined on input lin e 55206. LaTeX Warning: Hyper reference `CmpMap' on page 980 undefined on input line 552 07. LaTeX Warning: Hyper reference `SlaMap' on page 980 undefined on input line 552 10. LaTeX Warning: Hyper reference `SpecMap' on page 980 undefined on input line 55 213. LaTeX Warning: Hyper reference `XmlChan' on page 980 undefined on input line 55 228. LaTeX Warning: Hyper reference `Channel' on page 980 undefined on input line 55 228. LaTeX Warning: Hyper reference `Plot' on page 980 undefined on input line 55230 . LaTeX Warning: Hyper reference `astPutCards' on page 980 undefined on input lin e 55248. LaTeX Warning: Hyper reference `FitsChan' on page 980 undefined on input line 5 5249. [980] LaTeX Warning: Hyper reference `Plot' on page 981 undefined on input line 55267 . LaTeX Warning: Hyper reference `Escape' on page 981 undefined on input line 552 70. LaTeX Warning: Hyper reference `Tol' on page 981 undefined on input line 55272. LaTeX Warning: Hyper reference `SkyAxis' on page 981 undefined on input line 55 288. LaTeX Warning: Hyper reference `ast_link' on page 981 undefined on input line 5 5301. [981] LaTeX Warning: Hyper reference `astEscapes' on page 982 undefined on input line 55315. LaTeX Warning: Hyper reference `astFormat' on page 982 undefined on input line 55316. LaTeX Warning: Hyper reference `XmlPrefix' on page 982 undefined on input line 55319. LaTeX Warning: Hyper reference `XmlChan' on page 982 undefined on input line 55 319. LaTeX Warning: Hyper reference `XmlFormat' on page 982 undefined on input line 55323. LaTeX Warning: Hyper reference `Mapping' on page 982 undefined on input line 55 326. LaTeX Warning: Hyper reference `TranMap' on page 982 undefined on input line 55 326. LaTeX Warning: Hyper reference `WcsMap' on page 982 undefined on input line 553 30. LaTeX Warning: Hyper reference `SkyFrame' on page 982 undefined on input line 5 5342. LaTeX Warning: Hyper reference `SkyRefIs' on page 982 undefined on input line 5 5345. LaTeX Warning: Hyper reference `AlignOffset' on page 982 undefined on input lin e 55345. LaTeX Warning: Hyper reference `FitsChan' on page 982 undefined on input line 5 5347. LaTeX Warning: Hyper reference `Iwc' on page 982 undefined on input line 55352. [982] LaTeX Warning: Hyper reference `Mapping' on page 983 undefined on input line 55 399. LaTeX Warning: Hyper reference `astLinearApprox' on page 983 undefined on input line 55400. LaTeX Warning: Hyper reference `SkyFrame' on page 983 undefined on input line 5 5406. LaTeX Warning: Hyper reference `Frame' on page 983 undefined on input line 5540 6. LaTeX Warning: Hyper reference `Plot' on page 983 undefined on input line 55411 . LaTeX Warning: Hyper reference `DSBSpecFrame' on page 983 undefined on input li ne 55420. LaTeX Warning: Hyper reference `SpecFrame' on page 983 undefined on input line 55421. LaTeX Warning: Hyper reference `FitsChan' on page 983 undefined on input line 5 5424. LaTeX Warning: Hyper reference `Encoding' on page 983 undefined on input line 5 5428. LaTeX Warning: Hyper reference `Region' on page 983 undefined on input line 554 44. [983] LaTeX Warning: Hyper reference `Frame' on page 984 undefined on input line 5545 2. LaTeX Warning: Hyper reference `FluxFrame' on page 984 undefined on input line 55452. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 984 undefined on input l ine 55456. LaTeX Warning: Hyper reference `Mapping' on page 984 undefined on input line 55 460. LaTeX Warning: Hyper reference `RateMap' on page 984 undefined on input line 55 460. LaTeX Warning: Hyper reference `SkyFrame' on page 984 undefined on input line 5 5466. LaTeX Warning: Hyper reference `System' on page 984 undefined on input line 554 66. LaTeX Warning: Hyper reference `KeyMap' on page 984 undefined on input line 554 70. LaTeX Warning: Hyper reference `astRate' on page 984 undefined on input line 55 475. LaTeX Warning: Hyper reference `FitsChan' on page 984 undefined on input line 5 5482. LaTeX Warning: Hyper reference `SkyFrame' on page 984 undefined on input line 5 5495. LaTeX Warning: Hyper reference `Frame' on page 984 undefined on input line 5549 8. LaTeX Warning: Hyper reference `Plot' on page 984 undefined on input line 55500 . LaTeX Warning: Hyper reference `Clip' on page 984 undefined on input line 55500 . LaTeX Warning: Hyper reference `PolyMap' on page 984 undefined on input line 55 503. LaTeX Warning: Hyper reference `Channel' on page 984 undefined on input line 55 504. LaTeX Warning: Hyper reference `FitsChan' on page 984 undefined on input line 5 5505. [984] LaTeX Warning: Hyper reference `ast_link' on page 985 undefined on input line 5 5514. LaTeX Warning: Hyper reference `TimeFrame' on page 985 undefined on input line 55530. LaTeX Warning: Hyper reference `TimeMap' on page 985 undefined on input line 55 530. LaTeX Warning: Hyper reference `Frame' on page 985 undefined on input line 5553 1. LaTeX Warning: Hyper reference `Epoch' on page 985 undefined on input line 5553 3. LaTeX Warning: Hyper reference `Mapping' on page 985 undefined on input line 55 534. LaTeX Warning: Hyper reference `XmlChan' on page 985 undefined on input line 55 550. LaTeX Warning: Hyper reference `Mapping' on page 985 undefined on input line 55 554. Overfull \hbox (36.88722pt too wide) in paragraph at lines 55553--55556 \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 985 undefined on input line 5 5575. LaTeX Warning: Hyper reference `System' on page 985 undefined on input line 555 75. [985] LaTeX Warning: Hyper reference `FitsChan' on page 986 undefined on input line 5 5578. LaTeX Warning: Hyper reference `Frame' on page 986 undefined on input line 5558 1. LaTeX Warning: Hyper reference `ObsLon' on page 986 undefined on input line 555 81. LaTeX Warning: Hyper reference `ObsLat' on page 986 undefined on input line 555 81. LaTeX Warning: Hyper reference `TimeFrame' on page 986 undefined on input line 55585. LaTeX Warning: Hyper reference `SpecFrame' on page 986 undefined on input line 55586. LaTeX Warning: Hyper reference `astMapSplit' on page 986 undefined on input lin e 55593. LaTeX Warning: Hyper reference `Mapping' on page 986 undefined on input line 55 594. LaTeX Warning: Hyper reference `SkyRefIs' on page 986 undefined on input line 5 5598. LaTeX Warning: Hyper reference `SideBand' on page 986 undefined on input line 5 5613. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 986 undefined on input li ne 55613. LaTeX Warning: Hyper reference `FitsChan' on page 986 undefined on input line 5 5618. LaTeX Warning: Hyper reference `FrameSet' on page 986 undefined on input line 5 5621. LaTeX Warning: Hyper reference `astRetainFits' on page 986 undefined on input l ine 55624. LaTeX Warning: Hyper reference `Object' on page 986 undefined on input line 556 26. LaTeX Warning: Hyper reference `ObjSize' on page 986 undefined on input line 55 633. LaTeX Warning: Hyper reference `Class' on page 986 undefined on input line 5563 4. LaTeX Warning: Hyper reference `Channel' on page 986 undefined on input line 55 637. [986] LaTeX Warning: Hyper reference `astTune' on page 987 undefined on input line 55 640. LaTeX Warning: Hyper reference `astTranGrid' on page 987 undefined on input lin e 55646. LaTeX Warning: Hyper reference `Mapping' on page 987 undefined on input line 55 647. LaTeX Warning: Hyper reference `SwitchMap' on page 987 undefined on input line 55653. LaTeX Warning: Hyper reference `SelectorMap' on page 987 undefined on input lin e 55658. LaTeX Warning: Hyper reference `Region' on page 987 undefined on input line 556 60. LaTeX Warning: Hyper reference `astConvert' on page 987 undefined on input line 55664. LaTeX Warning: Hyper reference `CmpFrame' on page 987 undefined on input line 5 5665. LaTeX Warning: Hyper reference `Frame' on page 987 undefined on input line 5566 5. LaTeX Warning: Hyper reference `SkyFrame' on page 987 undefined on input line 5 5669. LaTeX Warning: Hyper reference `SpecFrame' on page 987 undefined on input line 55670. LaTeX Warning: Hyper reference `ast_link_adam' on page 987 undefined on input l ine 55673. LaTeX Warning: Hyper reference `ast_link' on page 987 undefined on input line 5 5673. LaTeX Warning: Hyper reference `SpecFrame' on page 987 undefined on input line 55691. LaTeX Warning: Hyper reference `SourceSys' on page 987 undefined on input line 55691. LaTeX Warning: Hyper reference `SourceVel' on page 987 undefined on input line 55692. LaTeX Warning: Hyper reference `astFindFrame' on page 987 undefined on input li ne 55709. LaTeX Warning: Hyper reference `CmpFrame' on page 987 undefined on input line 5 5710. LaTeX Warning: Hyper reference `Frame' on page 987 undefined on input line 5571 1. LaTeX Warning: Hyper reference `SkyFrame' on page 987 undefined on input line 5 5711. LaTeX Warning: Hyper reference `TimeFrame' on page 987 undefined on input line 55711. LaTeX Warning: Hyper reference `SpecFrame' on page 987 undefined on input line 55711. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 987 undefined on input li ne 55711. LaTeX Warning: Hyper reference `FluxFrame' on page 987 undefined on input line 55712. LaTeX Warning: Hyper reference `FrameSet' on page 987 undefined on input line 5 5715. LaTeX Warning: Hyper reference `Mapping' on page 987 undefined on input line 55 718. LaTeX Warning: Hyper reference `PermMap' on page 987 undefined on input line 55 718. LaTeX Warning: Hyper reference `MaxAxes' on page 987 undefined on input line 55 721. LaTeX Warning: Hyper reference `MinAxes' on page 987 undefined on input line 55 721. [987] LaTeX Warning: Hyper reference `SideBand' on page 988 undefined on input line 5 5731. LaTeX Warning: Hyper reference `astConvert' on page 988 undefined on input line 55733. LaTeX Warning: Hyper reference `Dut1' on page 988 undefined on input line 55735 . LaTeX Warning: Hyper reference `ObsLat' on page 988 undefined on input line 557 39. LaTeX Warning: Hyper reference `ObsLon' on page 988 undefined on input line 557 40. LaTeX Warning: Hyper reference `AlignOffset' on page 988 undefined on input lin e 55742. LaTeX Warning: Hyper reference `UnitMap' on page 988 undefined on input line 55 747. LaTeX Warning: Hyper reference `Plot' on page 988 undefined on input line 55749 . LaTeX Warning: Hyper reference `FrameSet' on page 988 undefined on input line 5 5769. LaTeX Warning: Hyper reference `astWrite' on page 988 undefined on input line 5 5770. [988] LaTeX Warning: Hyper reference `astPurgeWCS' on page 989 undefined on input lin e 55779. LaTeX Warning: Hyper reference `FitsChan' on page 989 undefined on input line 5 5780. LaTeX Warning: Hyper reference `Plot' on page 989 undefined on input line 55783 . LaTeX Warning: Hyper reference `astGrfSet' on page 989 undefined on input line 55786. LaTeX Warning: Hyper reference `Frame' on page 989 undefined on input line 5580 8. LaTeX Warning: Hyper reference `astShowMesh' on page 989 undefined on input lin e 55814. LaTeX Warning: Hyper reference `Region' on page 989 undefined on input line 558 15. LaTeX Warning: Hyper reference `TimeFrame' on page 989 undefined on input line 55837. LaTeX Warning: Hyper reference `LTOffset' on page 989 undefined on input line 5 5839. LaTeX Warning: Hyper reference `Plot3D' on page 989 undefined on input line 558 41. [989] LaTeX Warning: Hyper reference `ObsLat' on page 990 undefined on input line 558 46. LaTeX Warning: Hyper reference `Frame' on page 990 undefined on input line 5584 6. LaTeX Warning: Hyper reference `SkyFrame' on page 990 undefined on input line 5 5850. LaTeX Warning: Hyper reference `astLock' on page 990 undefined on input line 55 868. LaTeX Warning: Hyper reference `astUnlock' on page 990 undefined on input line 55868. LaTeX Warning: Hyper reference `Object' on page 990 undefined on input line 558 68. LaTeX Warning: Hyper reference `TimeFrame' on page 990 undefined on input line 55871. LaTeX Warning: Hyper reference `LTOffset' on page 990 undefined on input line 5 5873. LaTeX Warning: Hyper reference `Channel' on page 990 undefined on input line 55 875. LaTeX Warning: Hyper reference `Strict' on page 990 undefined on input line 558 75. LaTeX Warning: Hyper reference `astUnlock' on page 990 undefined on input line 55891. LaTeX Warning: Hyper reference `Object' on page 990 undefined on input line 558 92. LaTeX Warning: Hyper reference `Prism' on page 990 undefined on input line 5589 5. LaTeX Warning: Hyper reference `Region' on page 990 undefined on input line 558 95. LaTeX Warning: Hyper reference `Box' on page 990 undefined on input line 55896. LaTeX Warning: Hyper reference `Interval' on page 990 undefined on input line 5 5896. LaTeX Warning: Hyper reference `astSimplify' on page 990 undefined on input lin e 55904. LaTeX Warning: Hyper reference `PointList' on page 990 undefined on input line 55908. LaTeX Warning: Hyper reference `ListSize' on page 990 undefined on input line 5 5912. [990] LaTeX Warning: Hyper reference `Channel' on page 991 undefined on input line 55 915. LaTeX Warning: Hyper reference `Strict' on page 991 undefined on input line 559 19. LaTeX Warning: Hyper reference `ReportLevel' on page 991 undefined on input lin e 55920. LaTeX Warning: Hyper reference `astWarnings' on page 991 undefined on input lin e 55921. LaTeX Warning: Hyper reference `FitsChan' on page 991 undefined on input line 5 5923. LaTeX Warning: Hyper reference `Frame' on page 991 undefined on input line 5593 1. LaTeX Warning: Hyper reference `astPickAxes' on page 991 undefined on input lin e 55940. LaTeX Warning: Hyper reference `astTestFits' on page 991 undefined on input lin e 55949. LaTeX Warning: Hyper reference `astSetFitsCM' on page 991 undefined on input li ne 55971. LaTeX Warning: Hyper reference `FitsChan' on page 991 undefined on input line 5 5972. LaTeX Warning: Hyper reference `ObsAlt' on page 991 undefined on input line 559 75. LaTeX Warning: Hyper reference `Frame' on page 991 undefined on input line 5597 5. LaTeX Warning: Hyper reference `TimeMap' on page 991 undefined on input line 55 984. LaTeX Warning: Hyper reference `SpecMap' on page 991 undefined on input line 55 984. [991] LaTeX Warning: Hyper reference `Polygon' on page 992 undefined on input line 55 988. LaTeX Warning: Hyper reference `Channel' on page 992 undefined on input line 55 997. LaTeX Warning: Hyper reference `StcsChan' on page 992 undefined on input line 5 5997. LaTeX Warning: Hyper reference `astRemoveRegions' on page 992 undefined on inpu t line 56001. LaTeX Warning: Hyper reference `Mapping' on page 992 undefined on input line 56 002. LaTeX Warning: Hyper reference `Region' on page 992 undefined on input line 560 03. LaTeX Warning: Hyper reference `astDownsize' on page 992 undefined on input lin e 56009. LaTeX Warning: Hyper reference `KeyMap' on page 992 undefined on input line 560 24. LaTeX Warning: Hyper reference `KeyError' on page 992 undefined on input line 5 6027. LaTeX Warning: Hyper reference `Class' on page 992 undefined on input line 5602 7. LaTeX Warning: Hyper reference `Frame' on page 992 undefined on input line 5604 2. LaTeX Warning: Hyper reference `astFindFrame' on page 992 undefined on input li ne 56043. LaTeX Warning: Hyper reference `astConvert' on page 992 undefined on input line 56043. LaTeX Warning: Hyper reference `Domain' on page 992 undefined on input line 560 46. LaTeX Warning: Hyper reference `SkyFrame' on page 992 undefined on input line 5 6048. LaTeX Warning: Hyper reference `UnitMap' on page 992 undefined on input line 56 049. LaTeX Warning: Hyper reference `astMatchAxes' on page 992 undefined on input li ne 56055. LaTeX Warning: Hyper reference `astAddFrame' on page 992 undefined on input lin e 56060. LaTeX Warning: Hyper reference `FrameSet' on page 992 undefined on input line 5 6061. [992] LaTeX Warning: Hyper reference `KeyMap' on page 993 undefined on input line 560 74. LaTeX Warning: Hyper reference `astMapPutU' on page 993 undefined on input line 56076. LaTeX Warning: Hyper reference `astMapCopy' on page 993 undefined on input line 56084. LaTeX Warning: Hyper reference `MapLocked' on page 993 undefined on input line 56087. LaTeX Warning: Hyper reference `Object' on page 993 undefined on input line 560 94. LaTeX Warning: Hyper reference `astHasAttribute' on page 993 undefined on input line 56094. LaTeX Warning: Hyper reference `SkyFrame' on page 993 undefined on input line 5 6098. LaTeX Warning: Hyper reference `StcsChan' on page 993 undefined on input line 5 6111. LaTeX Warning: Hyper reference `Mapping' on page 993 undefined on input line 56 114. LaTeX Warning: Hyper reference `astQuadApprox' on page 993 undefined on input l ine 56115. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 993 undefined on input line 56119. LaTeX Warning: Hyper reference `Channel' on page 993 undefined on input line 56 123. LaTeX Warning: Hyper reference `Indent' on page 993 undefined on input line 561 23. LaTeX Warning: Hyper reference `astWrite' on page 993 undefined on input line 5 6125. [993] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 994 undefined on input li ne 56142. LaTeX Warning: Hyper reference `FitsChan' on page 994 undefined on input line 5 6155. LaTeX Warning: Hyper reference `astSet' on page 994 undefined on input line 561 60. LaTeX Warning: Hyper reference `FrameSet' on page 994 undefined on input line 5 6167. LaTeX Warning: Hyper reference `astRead' on page 994 undefined on input line 56 167. LaTeX Warning: Hyper reference `KeyMap' on page 994 undefined on input line 561 69. LaTeX Warning: Hyper reference `SortBy' on page 994 undefined on input line 561 69. LaTeX Warning: Hyper reference `astMapKey' on page 994 undefined on input line 56171. LaTeX Warning: Hyper reference `FitsChan' on page 994 undefined on input line 5 6191. LaTeX Warning: Hyper reference `TabOK' on page 994 undefined on input line 5619 3. LaTeX Warning: Hyper reference `Table' on page 994 undefined on input line 5619 6. LaTeX Warning: Hyper reference `KeyMap' on page 994 undefined on input line 561 96. LaTeX Warning: Hyper reference `FitsTable' on page 994 undefined on input line 56199. LaTeX Warning: Hyper reference `KeyCase' on page 994 undefined on input line 56 207. LaTeX Warning: Hyper reference `astMapRename' on page 994 undefined on input li ne 56215. [994] LaTeX Warning: Hyper reference `FitsChan' on page 995 undefined on input line 5 6226. LaTeX Warning: Hyper reference `TabOK' on page 995 undefined on input line 5622 6. LaTeX Warning: Hyper reference `astWrite' on page 995 undefined on input line 5 6229. LaTeX Warning: Hyper reference `astRead' on page 995 undefined on input line 56 237. LaTeX Warning: Hyper reference `astBBuf' on page 995 undefined on input line 56 252. LaTeX Warning: Hyper reference `astEBuf' on page 995 undefined on input line 56 252. LaTeX Warning: Hyper reference `Plot' on page 995 undefined on input line 56253 . LaTeX Warning: Hyper reference `ast_link' on page 995 undefined on input line 5 6257. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 995 undefined on inpu t line 56269. LaTeX Warning: Hyper reference `Region' on page 995 undefined on input line 562 71. LaTeX Warning: Hyper reference `Table' on page 995 undefined on input line 5628 4. [995] LaTeX Warning: Hyper reference `astFindFrame' on page 996 undefined on input li ne 56290. LaTeX Warning: Hyper reference `Frame' on page 996 undefined on input line 5629 1. LaTeX Warning: Hyper reference `SkyFrame' on page 996 undefined on input line 5 6293. LaTeX Warning: Hyper reference `FitsChan' on page 996 undefined on input line 5 6305. LaTeX Warning: Hyper reference `PolyTan' on page 996 undefined on input line 56 317. LaTeX Warning: Hyper reference `PolyMap' on page 996 undefined on input line 56 323. LaTeX Warning: Hyper reference `astPolyTran' on page 996 undefined on input lin e 56324. LaTeX Warning: Hyper reference `Channel' on page 996 undefined on input line 56 338. LaTeX Warning: Hyper reference `SourceFile' on page 996 undefined on input line 56341. LaTeX Warning: Hyper reference `SinkFile' on page 996 undefined on input line 5 6341. LaTeX Warning: Hyper reference `FitsChan' on page 996 undefined on input line 5 6343. LaTeX Warning: Hyper reference `FrameSet' on page 996 undefined on input line 5 6344. LaTeX Warning: Hyper reference `astRead' on page 996 undefined on input line 56 346. LaTeX Warning: Hyper reference `PolyMap' on page 996 undefined on input line 56 349. [996] LaTeX Warning: Hyper reference `Object' on page 997 undefined on input line 563 62. LaTeX Warning: Hyper reference `astToString' on page 997 undefined on input lin e 56362. LaTeX Warning: Hyper reference `astFromString' on page 997 undefined on input l ine 56364. LaTeX Warning: Hyper reference `PolyMap' on page 997 undefined on input line 56 367. LaTeX Warning: Hyper reference `FitsChan' on page 997 undefined on input line 5 6371. LaTeX Warning: Hyper reference `astWriteFits' on page 997 undefined on input li ne 56372. LaTeX Warning: Hyper reference `SinkFile' on page 997 undefined on input line 5 6374. LaTeX Warning: Hyper reference `Nkey' on page 997 undefined on input line 56378 . LaTeX Warning: Hyper reference `CardType' on page 997 undefined on input line 5 6385. LaTeX Warning: Hyper reference `astReadFits' on page 997 undefined on input lin e 56389. LaTeX Warning: Hyper reference `astRead' on page 997 undefined on input line 56 393. LaTeX Warning: Hyper reference `FitsChan' on page 997 undefined on input line 5 6412. LaTeX Warning: Hyper reference `Plot' on page 997 undefined on input line 56417 . LaTeX Warning: Hyper reference `astTuneC' on page 997 undefined on input line 5 6423. [997] LaTeX Warning: Hyper reference `FitsChan' on page 998 undefined on input line 5 6434. LaTeX Warning: Hyper reference `AlignSystem' on page 998 undefined on input lin e 56439. LaTeX Warning: Hyper reference `CmpFrame' on page 998 undefined on input line 5 6496. LaTeX Warning: Hyper reference `SkyFrame' on page 998 undefined on input line 5 6498. [998] LaTeX Warning: Hyper reference `CmpRegion' on page 999 undefined on input line 56501. LaTeX Warning: Hyper reference `Region' on page 999 undefined on input line 565 02. LaTeX Warning: Hyper reference `Plot3D' on page 999 undefined on input line 565 06. LaTeX Warning: Hyper reference `FitsChan' on page 999 undefined on input line 5 6536. LaTeX Warning: Hyper reference `FrameSet' on page 999 undefined on input line 5 6553. [999] LaTeX Warning: Hyper reference `astAddFrame' on page 1000 undefined on input li ne 56578. LaTeX Warning: Hyper reference `FrameSet' on page 1000 undefined on input line 56579. LaTeX Warning: Hyper reference `astRate' on page 1000 undefined on input line 5 6584. LaTeX Warning: Hyper reference `FitsChan' on page 1000 undefined on input line 56596. LaTeX Warning: Hyper reference `SkyFrame' on page 1000 undefined on input line 56596. LaTeX Warning: Hyper reference `SkyRefIs' on page 1000 undefined on input line 56597. LaTeX Warning: Hyper reference `FrameSet' on page 1000 undefined on input line 56603. LaTeX Warning: Hyper reference `Frame' on page 1000 undefined on input line 566 04. LaTeX Warning: Hyper reference `System' on page 1000 undefined on input line 56 605. LaTeX Warning: Hyper reference `astMapDefined' on page 1000 undefined on input line 56617. LaTeX Warning: Hyper reference `KeyMap' on page 1000 undefined on input line 56 618. LaTeX Warning: Hyper reference `FrameSet' on page 1000 undefined on input line 56637. LaTeX Warning: Hyper reference `Frame' on page 1000 undefined on input line 566 37. LaTeX Warning: Hyper reference `Mapping' on page 1000 undefined on input line 5 6640. LaTeX Warning: Hyper reference `Variant' on page 1000 undefined on input line 5 6640. [1000] LaTeX Warning: Hyper reference `Ident' on page 1001 undefined on input line 566 43. LaTeX Warning: Hyper reference `astSimplify' on page 1001 undefined on input li ne 56645. LaTeX Warning: Hyper reference `KeyMap' on page 1001 undefined on input line 56 673. LaTeX Warning: Hyper reference `SortBy' on page 1001 undefined on input line 56 675. LaTeX Warning: Hyper reference `FitsChan' on page 1001 undefined on input line 56677. LaTeX Warning: Hyper reference `FitsChan' on page 1001 undefined on input line 56690. LaTeX Warning: Hyper reference `CardName' on page 1001 undefined on input line 56690. LaTeX Warning: Hyper reference `CardComm' on page 1001 undefined on input line 56690. [1001] LaTeX Warning: Hyper reference `SimpVertices' on page 1002 undefined on input l ine 56711. LaTeX Warning: Hyper reference `Polygon' on page 1002 undefined on input line 5 6714. LaTeX Warning: Hyper reference `PolyMap' on page 1002 undefined on input line 5 6730. LaTeX Warning: Hyper reference `Base' on page 1002 undefined on input line 5674 7. LaTeX Warning: Hyper reference `Current' on page 1002 undefined on input line 5 6747. LaTeX Warning: Hyper reference `FrameSet' on page 1002 undefined on input line 56747. LaTeX Warning: Hyper reference `Domain' on page 1002 undefined on input line 56 748. LaTeX Warning: Hyper reference `Frame' on page 1002 undefined on input line 567 48. LaTeX Warning: Hyper reference `astWrite' on page 1002 undefined on input line 56749. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 1002 undefined on input line 56750. LaTeX Warning: Hyper reference `astAppendString' on page 1002 undefined on inpu t line 56752. LaTeX Warning: Hyper reference `astAppendString' on page 1002 undefined on inpu t line 56765. LaTeX Warning: Hyper reference `astAppendStringf' on page 1002 undefined on inp ut line 56766. [1002] LaTeX Warning: Hyper reference `astTranGrid' on page 1003 undefined on input li ne 56780. LaTeX Warning: Hyper reference `astAddFrame' on page 1003 undefined on input li ne 56799. LaTeX Warning: Hyper reference `FrameSet' on page 1003 undefined on input line 56800. LaTeX Warning: Hyper reference `Mapping' on page 1003 undefined on input line 5 6800. LaTeX Warning: Hyper reference `Frame' on page 1003 undefined on input line 568 01. LaTeX Warning: Hyper reference `astRegionOutline' on page 1003 undefined on inp ut line 56813. LaTeX Warning: Hyper reference `Plot' on page 1003 undefined on input line 5681 4. LaTeX Warning: Hyper reference `Region' on page 1003 undefined on input line 56 815. LaTeX Warning: Hyper reference `SkyFrame' on page 1003 undefined on input line 56826. [1003] LaTeX Warning: Hyper reference `LutMap' on page 1004 undefined on input line 56 831. LaTeX Warning: Hyper reference `LutEpsilon' on page 1004 undefined on input lin e 56831. LaTeX Warning: Hyper reference `SkyFrame' on page 1004 undefined on input line 56844. LaTeX Warning: Hyper reference `SkyTol' on page 1004 undefined on input line 56 844. LaTeX Warning: Hyper reference `Mapping' on page 1004 undefined on input line 5 6846. LaTeX Warning: Hyper reference `FitsChan' on page 1004 undefined on input line 56849. LaTeX Warning: Hyper reference `Warnings' on page 1004 undefined on input line 56856. LaTeX Warning: Hyper reference `astWarnings' on page 1004 undefined on input li ne 56857. LaTeX Warning: Hyper reference `Mapping' on page 1004 undefined on input line 5 6882. LaTeX Warning: Hyper reference `UnitNormMap' on page 1004 undefined on input li ne 56882. LaTeX Warning: Hyper reference `GrismMap' on page 1004 undefined on input line 56897. LaTeX Warning: Hyper reference `LutMap' on page 1004 undefined on input line 56 897. LaTeX Warning: Hyper reference `PcdMap' on page 1004 undefined on input line 56 897. LaTeX Warning: Hyper reference `SphMap' on page 1004 undefined on input line 56 897. LaTeX Warning: Hyper reference `WcsMap' on page 1004 undefined on input line 56 897. LaTeX Warning: Hyper reference `ZoomMap' on page 1004 undefined on input line 5 6897. [1004] LaTeX Warning: Hyper reference `astAxNorm' on page 1005 undefined on input line 56908. LaTeX Warning: Hyper reference `Frame' on page 1005 undefined on input line 569 09. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 1005 undefined on i nput line 56914. LaTeX Warning: Hyper reference `NormMap' on page 1005 undefined on input line 5 6930. LaTeX Warning: Hyper reference `Frame' on page 1005 undefined on input line 569 32. LaTeX Warning: Hyper reference `UnitMap' on page 1005 undefined on input line 5 6933. LaTeX Warning: Hyper reference `astTimeAdd' on page 1005 undefined on input lin e 56935. LaTeX Warning: Hyper reference `TimeMap' on page 1005 undefined on input line 5 6936. LaTeX Warning: Hyper reference `astSlaAdd' on page 1005 undefined on input line 56940. LaTeX Warning: Hyper reference `SlaMap' on page 1005 undefined on input line 56 941. LaTeX Warning: Hyper reference `astSpecAdd' on page 1005 undefined on input lin e 56945. LaTeX Warning: Hyper reference `SpecMap' on page 1005 undefined on input line 5 6946. LaTeX Warning: Hyper reference `astMapRegion' on page 1005 undefined on input l ine 56957. LaTeX Warning: Hyper reference `Region' on page 1005 undefined on input line 56 958. LaTeX Warning: Hyper reference `Mapping' on page 1005 undefined on input line 5 6960. [1005] LaTeX Warning: Hyper reference `Mapping' on page 1006 undefined on input line 5 6974. LaTeX Warning: Hyper reference `ChebyMap' on page 1006 undefined on input line 56974. LaTeX Warning: Hyper reference `PolyMap' on page 1006 undefined on input line 5 6977. LaTeX Warning: Hyper reference `TranForward' on page 1006 undefined on input li ne 56978. LaTeX Warning: Hyper reference `TranInverse' on page 1006 undefined on input li ne 56978. LaTeX Warning: Hyper reference `KeyMap' on page 1006 undefined on input line 56 981. LaTeX Warning: Hyper reference `astMapGetC' on page 1006 undefined on input lin e 56982. LaTeX Warning: Hyper reference `astSetPutErr' on page 1006 undefined on input l ine 56991. LaTeX Warning: Hyper reference `Frame' on page 1006 undefined on input line 569 96. LaTeX Warning: Hyper reference `Epoch' on page 1006 undefined on input line 569 98. LaTeX Warning: Hyper reference `TimeMap' on page 1006 undefined on input line 5 7003. LaTeX Warning: Hyper reference `Dtai' on page 1006 undefined on input line 5700 4. LaTeX Warning: Hyper reference `astLinearApprox' on page 1006 undefined on inpu t line 57023. LaTeX Warning: Hyper reference `Mapping' on page 1006 undefined on input line 5 7023. [1006] LaTeX Warning: Hyper reference `astWrite' on page 1007 undefined on input line 57031. LaTeX Warning: Hyper reference `FitsChan' on page 1007 undefined on input line 57031. LaTeX Warning: Hyper reference `SipOK' on page 1007 undefined on input line 570 34. LaTeX Warning: Hyper reference `FrameSet' on page 1007 undefined on input line 57035. LaTeX Warning: Hyper reference `PolyMap' on page 1007 undefined on input line 5 7036. LaTeX Warning: Hyper reference `astCreatedAt' on page 1007 undefined on input l ine 57038. LaTeX Warning: Hyper reference `astAddFrame' on page 1007 undefined on input li ne 57047. LaTeX Warning: Hyper reference `Region' on page 1007 undefined on input line 57 059. LaTeX Warning: Hyper reference `FitsChan' on page 1007 undefined on input line 57059. LaTeX Warning: Hyper reference `Mapping' on page 1007 undefined on input line 5 7065. LaTeX Warning: Hyper reference `Region' on page 1007 undefined on input line 57 079. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 1007 undefined on inp ut line 57079. LaTeX Warning: Hyper reference `Moc' on page 1007 undefined on input line 57083 . LaTeX Warning: Hyper reference `Bounded' on page 1007 undefined on input line 5 7087. LaTeX Warning: Hyper reference `SkyFrame' on page 1007 undefined on input line 57088. [1007] LaTeX Warning: Hyper reference `Moc' on page 1008 undefined on input line 57101 . LaTeX Warning: Hyper reference `astGetMocString' on page 1008 undefined on inpu t line 57103. LaTeX Warning: Hyper reference `astAddMocString' on page 1008 undefined on inpu t line 57103. LaTeX Warning: Hyper reference `MocChan' on page 1008 undefined on input line 5 7104. LaTeX Warning: Hyper reference `FitsChan' on page 1008 undefined on input line 57106. LaTeX Warning: Hyper reference `FitsChan' on page 1008 undefined on input line 57154. LaTeX Warning: Hyper reference `ForceTab' on page 1008 undefined on input line 57154. LaTeX Warning: Hyper reference `TabOK' on page 1008 undefined on input line 571 55. LaTeX Warning: Hyper reference `FrameSet' on page 1008 undefined on input line 57156. [1008] LaTeX Warning: Hyper reference `TimeFrame' on page 1009 undefined on input line 57169. LaTeX Warning: Hyper reference `astCurrentTime' on page 1009 undefined on input line 57170. LaTeX Warning: Hyper reference `Region' on page 1009 undefined on input line 57 172. LaTeX Warning: Hyper reference `astPointInRegion' on page 1009 undefined on inp ut line 57172. LaTeX Warning: Hyper reference `FitsChan' on page 1009 undefined on input line 57183. LaTeX Warning: Hyper reference `KeyMap' on page 1009 undefined on input line 57 198. LaTeX Warning: Hyper reference `astMapCopyEntry' on page 1009 undefined on inpu t line 57198. LaTeX Warning: Hyper reference `astSimplify' on page 1009 undefined on input li ne 57202. LaTeX Warning: Hyper reference `Channel' on page 1009 undefined on input line 5 7218. LaTeX Warning: Hyper reference `YamlChan' on page 1009 undefined on input line 57218. [1009] LaTeX Warning: Hyper reference `astWrite' on page 1010 undefined on input line 57231. LaTeX Warning: Hyper reference `FitsChan' on page 1010 undefined on input line 57232. LaTeX Warning: Hyper reference `FrameSet' on page 1010 undefined on input line 57233. LaTeX Warning: Hyper reference `AltAxes' on page 1010 undefined on input line 5 7235. LaTeX Warning: Hyper reference `KeyMap' on page 1010 undefined on input line 57 239. LaTeX Warning: Hyper reference `YamlChan' on page 1010 undefined on input line 57243. LaTeX Warning: Hyper reference `astNormPoints' on page 1010 undefined on input line 57253. LaTeX Warning: Hyper reference `Frame' on page 1010 undefined on input line 572 53. LaTeX Warning: Hyper reference `astNorm' on page 1010 undefined on input line 5 7254. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 1010 undefined on inp ut line 57262. LaTeX Warning: Hyper reference `astShowMesh' on page 1010 undefined on input li ne 57262. LaTeX Warning: Hyper reference `KeyMap' on page 1010 undefined on input line 57 266. [1010] LaTeX Warning: Hyper reference `FitsChan' on page 1011 undefined on input line 57289. LaTeX Warning: Hyper reference `FitsChan' on page 1011 undefined on input line 57303. LaTeX Warning: Hyper reference `FitsRounding' on page 1011 undefined on input l ine 57303. [1011] (./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.71828182 (TeX Live 2025/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. LaTeX Warning: There were undefined references. LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right. Package rerunfilecheck Warning: File `sun211.out' has changed. (rerunfilecheck) Rerun to get outlines right (rerunfilecheck) or use package `bookmark'. ) (\end occurred inside a group at level 1) ### simple group (level 1) entered at line 6736 ({) ### bottom level (see the transcript file for additional information) 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.71828182 (TeX Live 2025/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.71828182 (TeX Live 2025/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.71828182 (TeX Live 2025/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. < /usr/share/texlive/texmf-dist/fonts/type1/urw/palatino/uplb8a.pfb> Output written on sun211.pdf (1015 pages, 2534940 bytes). Transcript written on sun211.log. This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2025/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2024-11-01> L3 programming layer <2024-11-02> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2024/06/29 v1.4n Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size11.clo)) ..........Article!.......... (/usr/share/texlive/texmf-dist/tex/generic/iftex/ifpdf.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty)) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty) (/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/etoolbox/etoolbox.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/translations/translations.sty (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/infwarerr/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty))) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.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) Package xcolor Warning: Package option `usenames' is obsolete and ignored on in put line 265. (/usr/share/texlive/texmf-dist/tex/latex/graphics/mathcolor.ltx)) (/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/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/latex/kvsetkeys/kvsetkeys.sty)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/zref/zref-abspage.sty (/usr/share/texlive/texmf-dist/tex/latex/zref/zref-base.sty (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/etexcmds/etexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/auxhook/auxhook.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-latex.def) (/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/pgfkeyslibraryfiltered .code.tex)) (/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/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/pgfmathcalc.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfint.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/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/pdflscape/pdflscape.sty (/usr/share/texlive/texmf-dist/tex/latex/pdflscape/pdflscape-nometadata.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/lscape.sty))) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/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/pdfescape/pdfescape.sty) (/usr/share/texlive/texmf-dist/tex/latex/hycolor/hycolor.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (/usr/share/texlive/texmf-dist/tex/generic/stringenc/stringenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/generic/intcalc/intcalc.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/puenc.def) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/latex/base/atveryend-ltx.sty) (/usr/share/texlive/texmf-dist/tex/generic/uniquecounter/uniquecounter.sty (/usr/share/texlive/texmf-dist/tex/generic/bigintcalc/bigintcalc.sty)))) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty) (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/atbegshi-ltx.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty) (/usr/share/texmf/tex/latex/html/html.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) (./sst.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) (./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/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/translations/translations-basic-dictio nary-english.trsl) (/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/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) *geometry* driver: auto-detecting *geometry* detected driver: pdftex (./sun211.out) (./sun211.out) Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}{/usr/share/texlive/texmf- dist/fonts/enc/dvips/base/8r.enc} <./sun211_figures/fronta.pdf> <./sun211_figur es/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 >] (/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) [2] (./sun211.toc [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21]) [22] (./sun211.lof) [23] [1] (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ts1ppl.fd) [2] [3] [4] [5 <./sun211_figures/mapping.pdf>] Overfull \hbox (16.47258pt 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 <./sun211_figures/complex.pdf>] [9 <./sun211_figures/frames.pdf>] [10 <./sun211_figures/cmpframe.pdf>] [11 <./sun211_figures/frameset.pdf>] [12] [13 <./sun211_figures/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 4742. [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94] [95] [96] [97] [98 <./sun211_figures/dsbspec1.pdf>] [99] [100] [101 <./sun211_figures/dsbspec2.pdf>] [102 <./sun211_figures/dsbspec3.pdf>] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115] [116] [117 <./sun211_figures/fsexample.pdf>] [118] [119] [120] [121] [122] [123 <./sun211_figures/fsconvert.pdf>] [124] [125 <./sun211_figures/fsalign.pdf>] [126] [127] [128] [129 <./sun211_figures/fsremap.pdf>] [130] [131] [132 <./sun211_figures/fsmerge.pdf>] [133] [134] [135] [136] [137] [138] [139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150] [151] [152] [153] [154] [155] [156] [157] [158] [159] [160] [161] [162] [163] [164] [165] [166] [167] Overfull \hbox (135.00621pt too wide) in paragraph at lines 9848--9851 []\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/ [168] [169] [170] [171] [172] [173] [174] [175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186] [187] [188] [189] [190] [191] [192] [193] [194] [195] Overfull \hbox (10.86975pt too wide) in paragraph at lines 11344--11344 \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 11344--11344 [] \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 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 11344--11344 Underfull \hbox (badness 10000) in paragraph at lines 11344--11344 [] \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 11344--11344 [][]\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 11344--11344 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [196] Overfull \hbox (42.36206pt too wide) in paragraph at lines 11344--11344 [][]\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 11344--11344 \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 11344--11344 \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 11344--11344 [][]\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 11344--11344 \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 11344--11344 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [197] Overfull \hbox (28.19052pt too wide) in paragraph at lines 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 Overfull \hbox (12.49844pt too wide) in paragraph at lines 11425--11425 \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 11425--11425 \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 11425--11425 \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 11425--11425 []\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 11425--11425 [][]\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 11425--11425 [][]\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 11425--11425 [][]\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 11425--11425 \T1/cmtt/m/n/10 value and will have a routine name equal to the upper case Fort ran routine that [198] Overfull \hbox (26.6159pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 Indicates how the Moc and specified cell are to be combined. An y of the following Overfull \hbox (41.84367pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__AND: If the specified cell is included in the Moc, it is removed. Otherwise Overfull \hbox (47.09239pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__OR: If the specified cell is not included in the Moc, it is added. Otherwise Overfull \hbox (46.82996pt too wide) in paragraph at lines 11484--11484 [][]\T1/cmtt/m/n/10 AST__XOR: The specified cell is toggled - it is removed fro m the Moc if originally Overfull \hbox (10.60732pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 The HEALPix order of the cell. An error is reported if this is higher than the Overfull \hbox (0.37231pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 maximum order allowed in the Moc (as given by its []MaxOrder[] attribute). If no Overfull \hbox (10.60732pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 value has been set for the MaxOrder attribute, calling this met hod causes it to Overfull \hbox (5.3586pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 be set to the supplied order value. So the highest order cells should usually Overfull \hbox (10.34488pt too wide) in paragraph at lines 11484--11484 \T1/cmtt/m/n/10 The " npix" value identifying the required cell (see the MOC re commendation for [199] Overfull \hbox (5.52135pt too wide) in paragraph at lines 11578--11578 []\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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 \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 11578--11578 [][]\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 11578--11578 \T1/cmtt/m/n/10 the supplied name and properties. However an error is reported if any of the [200] Overfull \hbox (7.09596pt too wide) in paragraph at lines 11696--11696 []\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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 []\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 11696--11696 [][]\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 11696--11696 \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 11696--11696 [][]\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 11696--11696 [][]\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 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \T1/cmtt/m/n/10 the " frame" FrameSet. This latter Frame becomes the current Fr ame in the merged [201] Overfull \hbox (10.60732pt too wide) in paragraph at lines 11696--11696 [][]\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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \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 11696--11696 \T1/cmtt/m/n/10 in the supplied Frame. Each new CmpMap is simplified using []as tSimplify[] before [202] Overfull \hbox (7.72334pt too wide) in paragraph at lines 11801--11801 []\T1/cmtt/m/n/10 void astAddMocData( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n /10 this, int cmode, int negate, int maxorder, int len, int Overfull \hbox (10.86975pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 Indicates how the Moc and data are to be combined. Any of the f ollowing values Overfull \hbox (5.10265pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 If non-zero, the cells added to the Moc will be those included in the supplied Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 data array. If zero, the cells added to the Moc will be those n ot included in Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The maximum HEALPix order to use. If a negative value is suppli ed, the maximum Overfull \hbox (17.69308pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 order will be determined by searching the data array (this will take extra time). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 In either case, if a value has already been set for the []MaxOr der[] attribute in Overfull \hbox (0.37231pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 the Moc, then the attribute value is used in preference to the value supplied Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 for this parameter. Any HEALPix cells in the data array that re fer to an order Overfull \hbox (15.85603pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The length of the supplied array (i.e. the number of 4 or 8 byt e integer values Overfull \hbox (10.86975pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 it contains). Note, this class only supports binary MOCs with l engths that can Overfull \hbox (0.10988pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 The number of bytes in each integer value stored in the supplie d array. Must Overfull \hbox (21.36719pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 Pointer to the data array holding a description of a MOC in the form used by FITS Overfull \hbox (16.11847pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 binary tables. See the IVOA MOC recommendation for details. The values in this Overfull \hbox (10.60732pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 array are signed integers, each with the number of bytes specif ied by parameter Overfull \hbox (0.5835pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 " nbyte" . The number of bytes in this array should be at least " len$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 nbyte" Overfull \hbox (68.34322pt too wide) in paragraph at lines 11801--11801 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (5.62103pt too wide) in paragraph at lines 11801--11801 \T1/cmtt/m/n/10 set it to the value supplied for " Maxorder" , or to the larges t order present [203] [204] Overfull \hbox (10.3477pt too wide) in paragraph at lines 11906--11906 []\T1/cmtt/m/n/10 void astAddMocString( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int cmode, int negate, int maxorder, size_t len, Overfull \hbox (10.86975pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Indicates how the supplied MOC is to be combined with the exist ing Moc. Any of Overfull \hbox (5.10265pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the supplied Overfull \hbox (10.35136pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 If non-zero, the cells added to the existing Moc will be those included in the Overfull \hbox (42.36206pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 supplied MOC. If zero, the cells added to the existing Moc will be those not included Overfull \hbox (10.60732pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The maximum HEALPix order to use. If a negative value is suppli ed, the maximum Overfull \hbox (28.19052pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 order will be determined by searching the supplied MOC (this wi ll take extra time). Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 In either case, if a value has already been set for the []MaxOr der[] attribute in Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 the Moc, then the attribute value is used in preference to the value supplied Overfull \hbox (21.10475pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 for this parameter. Any HEALPix cells in the supplied MOC that refer to an order Overfull \hbox (5.09616pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The number of characters to read from the supplied string. If t his is greater Overfull \hbox (21.36719pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Pointer to the array of characters holding the supplied MOC. It should be encoded Overfull \hbox (22.9418pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 using either the string or JSON serialisation described in the MOC recommendation. Overfull \hbox (5.3586pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 The used serialisation is determined from the first non-blank c haracter, which Overfull \hbox (0.37231pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 should be either a curly brace (' {' - JSON serialisation) or a digit (string Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 Pointer to an int in which to return a boolean flag indicating if the supplied Overfull \hbox (12.44437pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 string was interpreted using the JSON (non-zero) or string (zer o) serialisation. Underfull \hbox (badness 10000) in paragraph at lines 11906--11906 [205] Overfull \hbox (68.34322pt too wide) in paragraph at lines 11906--11906 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (5.62103pt too wide) in paragraph at lines 11906--11906 \T1/cmtt/m/n/10 set it to the value supplied for " Maxorder" , or to the larges t order present [206] Overfull \hbox (33.1768pt too wide) in paragraph at lines 11942--11942 \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 11942--11942 [][]\T1/cmtt/m/n/10 Unlike columns, the definition of a parameter does not spec ify its type, size [207] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 12193. Overfull \hbox (12.46611pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 void astAddPixelMask$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\O ML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/1 0 this, int cmode, AstFrameSet $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 wcs, $\OML /zplm/m/it/10 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 valu e, Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Indicates how the Moc and select pixels are to be combined. Any of the following Overfull \hbox (5.10265pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (10.35136pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the selected Overfull \hbox (10.35136pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (10.86975pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Pointer to a FrameSet defining the World Coordinate Systems ass ociated with the Overfull \hbox (28.19052pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 image. The current Frame should be a SkyFrame or a CmpFrame con taining a SkyFrame. Overfull \hbox (26.35347pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The base Frame should have the same number of axes as the curre nt Frame and should Overfull \hbox (37.11334pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 represent " grid" coordinates within a pixel array (i.e. the fi rst pixel is centred Overfull \hbox (1.94693pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 at (1.0,1.0,...) and the distance between pixel centres is 1.0 on both axes). Overfull \hbox (15.85603pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The array supplied for parameter " array" is assumed to be a 2- dimensional slice [208] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Indicates how the " value" parameter is used to select the requ ired pixels. It Overfull \hbox (5.3586pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 The bitwise OR of a set of flag values which may be used to pro vide additional Overfull \hbox (42.36206pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 control over the operation. See the " Control Flags" section be low for a description Overfull \hbox (26.6159pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 of the options available. If no flag values are to be set, a va lue of zero should Overfull \hbox (10.60732pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 This parameter should have the same type as the elements of the data array. It Overfull \hbox (26.35347pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 specifies the value used to flag missing data (bad pixels). Suc h pixels are never Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 If the AST__USEBAD flag is set via the " flags" parameter, th en this value is Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Pointer to the 2-dimensional data array. The numerical type of this array should Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 match the 1- or 2-character type code appended to the function name (e.g. if Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 you are using astAddPixelMaskF, the type of each array element should be " float" Overfull \hbox (15.85603pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 The storage order of data within this array should be such th at the index of the Overfull \hbox (12.44437pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 first grid dimension varies most rapidly (i.e. Fortran array in dexing is used). Overfull \hbox (23.25832pt too wide) in paragraph at lines 12193--12193 []\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 (28.50703pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 additional control over the process. Having selected a set of f lags, you should supply Overfull \hbox (21.36719pt too wide) in paragraph at lines 12193--12193 [][]\T1/cmtt/m/n/10 AST__USEBAD: Indicates that there may be bad pixels in the input array which must Overfull \hbox (0.37231pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 be recognised by comparing with the value given for " badval" . If this flag Overfull \hbox (3.21706pt too wide) in paragraph at lines 12193--12193 []\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 12193--12193 \T1/cmtt/m/n/10 function name astAddPixelMask$\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 co de, so as to [209] Overfull \hbox (60.26178pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 For example, astAddPixelMaskD would be used to process " double " data, while astAddPixelMaskS Overfull \hbox (28.76947pt too wide) in paragraph at lines 12193--12193 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (44.51563pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 Specifically, the argument " dims" is changed from type " int" to type " int64_t" (defined Overfull \hbox (7.7746pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 in header file stdint.h). The function name is changed by inser ting the digit " 8" Overfull \hbox (53.24619pt too wide) in paragraph at lines 12193--12193 \T1/cmtt/m/n/10 before the trailing data type code. Thus, astAddPixelMask$\OML/ zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 becomes a stAddPixelMask8$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/c mtt/m/n/10 . Underfull \hbox (badness 10000) in paragraph at lines 12193--12193 [210] Overfull \hbox (21.36719pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 Indicates how the Moc and Region are to be combined. Any of the following values Overfull \hbox (5.10265pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__AND: The modified Moc is the intersection of the origi nal Moc and the Overfull \hbox (1.42854pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__OR: The modified Moc is the union of the original Moc and the Region. Overfull \hbox (10.35136pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 AST__XOR: The modified Moc is the exclusive disjunction of the original Moc Overfull \hbox (10.86975pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 When combining the Region with the Moc, it is assumed that the Moc has not been Overfull \hbox (17.69308pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 inverted (i.e. the current value of the Moc' s ' []Negated[]' a ttribute is ignored). Overfull \hbox (68.34322pt too wide) in paragraph at lines 12282--12282 [][]\T1/cmtt/m/n/10 If no value has yet been set for attribute MaxOrder, then t his function will automatically Overfull \hbox (21.36719pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 set it to a value that depends on the class of Region being add ed. If the Region Overfull \hbox (21.10475pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 being added is another Moc, the MaxOrder attribute of the Moc i s used. For other Overfull \hbox (10.60732pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 classes of Region, the value used corresponds to the resolution closest to 0.1% Overfull \hbox (54.43411pt too wide) in paragraph at lines 12282--12282 \T1/cmtt/m/n/10 of the linear size of the Region being added (determined using method []astGetRegionDisc[]). [211] Overfull \hbox (16.11847pt too wide) in paragraph at lines 12342--12342 \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 12342--12342 \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 12342--12342 \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 12342--12342 \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 12342--12342 [][]\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 12342--12342 [][]\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 12342--12342 [][]\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 12342--12342 \T1/cmtt/m/n/10 in another Frame. This is only the case if the []astMirrorVaria nts[] function has [212] Overfull \hbox (18.48322pt too wide) in paragraph at lines 12409--12409 []\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.09962pt too wide) in paragraph at lines 12409--12409 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Naxes[] attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12409--12409 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis (Naxes attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12409--12409 [] \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 12409--12409 \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 12409--12409 \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 12409--12409 \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 12409--12409 \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 12409--12409 [][]\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 12409--12409 [][]\T1/cmtt/m/n/10 A value of AST__BAD will also be returned if this function is invoked with the [213] Overfull \hbox (31.60219pt too wide) in paragraph at lines 12466--12466 [][]\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 12466--12466 [][]\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 12466--12466 \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 12466--12466 \T1/cmtt/m/n/10 circumstances. In particular, it will fail if the pointer suppl ed is not valid, [214] Overfull \hbox (42.09962pt too wide) in paragraph at lines 12533--12533 [] \T1/cmtt/m/n/10 An array of double, with one element for each Frame axis ([]Naxes[] attribute) containing Overfull \hbox (42.09962pt too wide) in paragraph at lines 12533--12533 [] \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 12533--12533 \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 12533--12533 [][]\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 12533--12533 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [215] Overfull \hbox (0.10988pt too wide) in paragraph at lines 12593--12593 \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 12593--12593 [][]\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 12593--12593 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [216] Overfull \hbox (39.63802pt too wide) in paragraph at lines 12667--12667 []\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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \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 12667--12667 \T1/cmtt/m/n/10 is made so that that the resulting list has the smallest range. Latitude values are [217] Overfull \hbox (0.10988pt too wide) in paragraph at lines 12727--12727 \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 12727--12727 [][]\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 12727--12727 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [218] Overfull \hbox (10.86975pt too wide) in paragraph at lines 12760--12760 [][]\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 12760--12760 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function to this function [219] [220] Overfull \hbox (34.01819pt too wide) in paragraph at lines 12863--12863 \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 12863--12863 \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 12863--12863 [][]\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 12863--12863 [][]\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 12863--12863 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the bas e and current Frames [221] Overfull \hbox (15.85603pt too wide) in paragraph at lines 12908--12908 \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 12908--12908 \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 12908--12908 \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 12908--12908 \T1/cmtt/m/n/10 each of the two axes of the graphics coordinate system (the bas e Frame of the [222] Overfull \hbox (31.55376pt too wide) in paragraph at lines 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 []\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 13046--13046 \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 13046--13046 \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 13046--13046 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 13046--13046 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [223] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13046--13046 \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 13046--13046 \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 13046--13046 \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 13046--13046 [] \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 13046--13046 \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 13046--13046 \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 13046--13046 [][]\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 13046--13046 []\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 13046--13046 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [224] Overfull \hbox (8.56807pt too wide) in paragraph at lines 13145--13145 []\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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 []\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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 []\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 13145--13145 \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 13145--13145 \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 13145--13145 \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 13145--13145 [] \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 13145--13145 \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 13145--13145 \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 13145--13145 [][]\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 13145--13145 \T1/cmtt/m/n/10 and sink functions using the []astPutChannelData[] function. Th e source or sink function [225] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13145--13145 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [226] Overfull \hbox (28.2446pt too wide) in paragraph at lines 13187--13187 \T1/cmtt/m/n/10 The pointer previously stored with the Channel using astPutChan nelData. A NULL pointer [227] Overfull \hbox (36.8509pt too wide) in paragraph at lines 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 \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 13253--13253 [][]\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 13253--13253 \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 13253--13253 \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 13253--13253 [][]\T1/cmtt/m/n/10 If the above procedure fails to determine a bounding box, t he supplied arrays [228] Overfull \hbox (23.4695pt too wide) in paragraph at lines 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \T1/cmtt/m/n/10 must not be negative, and floating point values are rounded to the nearest integer). [229] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 []\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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \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 13466--13466 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format [230] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13466--13466 [] \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 13466--13466 \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 13466--13466 \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 13466--13466 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [231] Overfull \hbox (13.18324pt too wide) in paragraph at lines 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 []\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 13589--13589 \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 13589--13589 \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 13589--13589 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 13589--13589 \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 13589--13589 \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 13589--13589 \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 13589--13589 \T1/cmtt/m/n/10 used is identical to that for the []astSet[] function and may i nclude " printf" format [232] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13589--13589 [] \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 13589--13589 \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 13589--13589 \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 13589--13589 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [233] Overfull \hbox (21.36719pt too wide) in paragraph at lines 13647--13647 \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 13647--13647 \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 13647--13647 \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 13647--13647 [] \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 13647--13647 \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 13647--13647 \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 13647--13647 [][]\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 13647--13647 \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 13647--13647 \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 13647--13647 \T1/cmtt/m/n/10 from original to new coordinate system is non-linear, the shape represented by [234] Overfull \hbox (10.86975pt too wide) in paragraph at lines 13700--13700 \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 13700--13700 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to clear the val ue of a read-only attribute. [235] Overfull \hbox (42.36206pt too wide) in paragraph at lines 13723--13723 [][]\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 13723--13723 \T1/cmtt/m/n/10 will not execute and will simply return without action. Using a stClearStatus [236] Overfull \hbox (6.6736pt too wide) in paragraph at lines 13835--13835 []\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 []\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 \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 13835--13835 \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 13835--13835 \T1/cmtt/m/n/10 plotted), you should supply all the bounds in reversed order, a nd set the ClipOp [237] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13835--13835 [][]\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 13835--13835 \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 13835--13835 [][]\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 13835--13835 \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 13835--13835 [][]\T1/cmtt/m/n/10 When a Plot is used as a []Mapping[] to transform points (e .g. using []astTran2[]), any [238] Overfull \hbox (5.62103pt too wide) in paragraph at lines 13883--13883 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [239] Overfull \hbox (0.48381pt too wide) in paragraph at lines 13971--13971 []\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 13971--13971 \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 13971--13971 \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 13971--13971 \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 13971--13971 [] \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 13971--13971 \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 13971--13971 \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 13971--13971 [][]\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 13971--13971 []\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 13971--13971 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [240] Overfull \hbox (42.47356pt too wide) in paragraph at lines 14090--14090 []\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 [] \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 14090--14090 \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 14090--14090 \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 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 [][]\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 14090--14090 \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 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 \T1/cmtt/m/n/10 requested, each Mapping will still be applied to the same coord inates, but in [241] Overfull \hbox (5.62103pt too wide) in paragraph at lines 14090--14090 [][]\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 14090--14090 [][]\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 14090--14090 \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 14090--14090 \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 14090--14090 \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 14090--14090 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [242] Overfull \hbox (8.1457pt too wide) in paragraph at lines 14204--14204 []\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 14204--14204 \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 14204--14204 \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 14204--14204 \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 14204--14204 \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 14204--14204 \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 14204--14204 \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 14204--14204 [] \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 14204--14204 \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 14204--14204 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [243] Overfull \hbox (5.3586pt too wide) in paragraph at lines 14204--14204 [][]\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 14204--14204 \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 14204--14204 \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 14204--14204 [][]\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 14204--14204 \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 14204--14204 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [244] Overfull \hbox (21.10475pt too wide) in paragraph at lines 14265--14265 \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 14265--14265 [][]\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 14265--14265 \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 14265--14265 \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 14265--14265 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [245] Overfull \hbox (8.19696pt too wide) in paragraph at lines 14383--14383 []\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 14383--14383 \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 14383--14383 [] \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \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 14383--14383 \T1/cmtt/m/n/10 the column contains any empty cells. Otherwise, a value of zero is returned. A value [246] Overfull \hbox (5.62103pt too wide) in paragraph at lines 14383--14383 [][]\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 14383--14383 \T1/cmtt/m/n/10 associated null value. This routine will return without action if the column [247] Overfull \hbox (2.89699pt too wide) in paragraph at lines 14448--14448 []\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 14448--14448 \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 14448--14448 \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 14448--14448 \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 14448--14448 [][]\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 14448--14448 \T1/cmtt/m/n/10 A value of zero is returned for " ndim" and the supplied values in " dims" are [248] Overfull \hbox (22.67937pt too wide) in paragraph at lines 14494--14494 \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 14494--14494 Overfull \hbox (1.94693pt too wide) in paragraph at lines 14494--14494 [][]\T1/cmtt/m/n/10 An error will be reported if the named column does not exis t in the FitsTable. [249] Overfull \hbox (0.37231pt too wide) in paragraph at lines 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [] \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \T1/cmtt/m/n/10 are described by Frames (rather than FrameSets), since there is then usually only [250] Overfull \hbox (2.52588pt too wide) in paragraph at lines 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \T1/cmtt/m/n/10 attention on it by specifying its domain in the " domainlist" s tring, or (b) making [251] Overfull \hbox (12.76088pt too wide) in paragraph at lines 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \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 14791--14791 \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 14791--14791 \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 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \T1/cmtt/m/n/10 Creates a FrameSet which describes precession in the default FK5 celestial Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 [] \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 14791--14791 \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 14791--14791 \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 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 []\T1/cmtt/m/n/10 The returned pointer " cvt" indicates whether conversion was possible and will Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 \T1/cmtt/m/n/10 have the value AST__NULL if it was not. If conversion was possi ble, " cvt" will [252] Underfull \hbox (badness 10000) in paragraph at lines 14791--14791 []\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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 [][]\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 14791--14791 \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 14791--14791 \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 14791--14791 \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 14791--14791 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [253] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 14993. Overfull \hbox (5.33546pt too wide) in paragraph at lines 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 []\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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \T1/cmtt/m/n/10 coordinate values at its centre or upper corner, as selected by parameter " starpix" [254] Overfull \hbox (15.85603pt too wide) in paragraph at lines 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 \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 14993--14993 [][]\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 14993--14993 []\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 14993--14993 \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 14993--14993 \T1/cmtt/m/n/10 For example, astConvexD would be used to process " double" data , while astConvexS would Overfull \hbox (28.76947pt too wide) in paragraph at lines 14993--14993 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (13.02332pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" and " ubnd" are changed fro m type " int" to type Overfull \hbox (34.01819pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 " int64_t" (defined in header file stdint.h). The function name is changed by inserting Overfull \hbox (68.99234pt too wide) in paragraph at lines 14993--14993 \T1/cmtt/m/n/10 the digit " 8" before the trailing data type code. Thus, astCon vex$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ \T1/cmtt/m/n/10 becomes astConvex8$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T 1/cmtt/m/n/10 . Underfull \hbox (badness 10000) in paragraph at lines 14993--14993 [255] Overfull \hbox (5.62103pt too wide) in paragraph at lines 15041--15041 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [256] Overfull \hbox (24.5254pt too wide) in paragraph at lines 15109--15109 []\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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 \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 15109--15109 [][]\T1/cmtt/m/n/10 NULL pointers and a line number of zero are returned if an error has already occurred [257] Overfull \hbox (26.35347pt too wide) in paragraph at lines 15165--15165 [][]\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 15165--15165 [][]\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 15165--15165 \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 15165--15165 \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 15165--15165 [][]\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 15165--15165 \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 15165--15165 [][]\T1/cmtt/m/n/10 Any inaccuracy in the system clock will be reflected in the value returned by [258] Overfull \hbox (42.09962pt too wide) in paragraph at lines 15238--15238 \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 15238--15238 \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 15238--15238 [][]\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 15238--15238 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [259] Overfull \hbox (10.86975pt too wide) in paragraph at lines 15312--15312 \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 15312--15312 \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 15312--15312 \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 15312--15312 [] \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 15312--15312 \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 15312--15312 \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 15312--15312 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [260] Overfull \hbox (27.14977pt too wide) in paragraph at lines 15438--15438 []\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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 \T1/cmtt/m/n/10 will be returned holding the current value of the Invert attrib ute for the supplied [261] Overfull \hbox (2.52588pt too wide) in paragraph at lines 15438--15438 \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 15438--15438 \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 15438--15438 \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 15438--15438 [][]\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 15438--15438 \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 15438--15438 [][]\T1/cmtt/m/n/10 Any changes made to the component Mappings using the return ed pointers will be [262] Overfull \hbox (10.86975pt too wide) in paragraph at lines 15477--15477 [][]\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 15477--15477 \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 15477--15477 [][]\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 15477--15477 \T1/cmtt/m/n/10 pointing at the " end-of-file" after deletion (i.e. is set to o ne more than the [263] Overfull \hbox (8.24539pt too wide) in paragraph at lines 15528--15528 [][]\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 15528--15528 \T1/cmtt/m/n/10 although no further error report will be made if it subsequentl y fails under these [264] Overfull \hbox (1.68732pt too wide) in paragraph at lines 15588--15588 []\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 15588--15588 \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 15588--15588 \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 15588--15588 [][]\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 15588--15588 [][]\T1/cmtt/m/n/10 A " bad" value will also be returned if this function is in voked with the AST [265] Overfull \hbox (42.09962pt too wide) in paragraph at lines 15647--15647 \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 15647--15647 \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 15647--15647 \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 15647--15647 \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 15647--15647 \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 15647--15647 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [266] Overfull \hbox (10.86975pt too wide) in paragraph at lines 15679--15679 [][]\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 15679--15679 \T1/cmtt/m/n/10 defined by the current grf module). Each call to this function simply invokes [267] Overfull \hbox (28.9294pt too wide) in paragraph at lines 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [268] Overfull \hbox (5.3586pt too wide) in paragraph at lines 15819--15819 []\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 15819--15819 \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 15819--15819 \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 15819--15819 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 \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 15819--15819 [] \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 15819--15819 \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 15819--15819 \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 15819--15819 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [269] Overfull \hbox (18.64314pt too wide) in paragraph at lines 15899--15899 []\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 15899--15899 \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 15899--15899 \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 15899--15899 \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 15899--15899 \T1/cmtt/m/n/10 sense as rotation from the positive direction of Y to the posit ive direction of Overfull \hbox (10.60732pt too wide) in paragraph at lines 15899--15899 [] \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 15899--15899 \T1/cmtt/m/n/10 axis of the ellipse. A NULL pointer can be supplied if these co ordinates are Overfull \hbox (15.85603pt too wide) in paragraph at lines 15899--15899 [] \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 15899--15899 \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 15899--15899 [][]\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 15899--15899 \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 15899--15899 \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 15899--15899 \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 15899--15899 [][]\T1/cmtt/m/n/10 Values of AST__BAD are returned for the parameters without error if the ellipse [270] Overfull \hbox (39.7377pt too wide) in paragraph at lines 15935--15935 [][]\T1/cmtt/m/n/10 This method simply deletes the cards currently in the FitsC han. Unlike []astWriteFits[], [271] [272] Overfull \hbox (27.92809pt too wide) in paragraph at lines 16037--16037 \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 16037--16037 \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 16037--16037 \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 16037--16037 \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 16037--16037 [][]\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 16037--16037 \T1/cmtt/m/n/10 sequences from the supplied string, or returns the supplied str ing without change. [273] [274] Overfull \hbox (0.37231pt too wide) in paragraph at lines 16113--16113 [][]\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 16113--16113 \T1/cmtt/m/n/10 within (or exported to) the current context and have not been r endered exempt [275] Overfull \hbox (31.86462pt too wide) in paragraph at lines 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 \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 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \T1/cmtt/m/n/10 Sets the Card attribute of a FitsChan to identify the next C OMMENT card (if [276] Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 Underfull \hbox (badness 10000) in paragraph at lines 16305--16305 [] \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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 [][]\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 16305--16305 \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 16305--16305 \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 16305--16305 [][]\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 16305--16305 [][]\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 16305--16305 []\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 16305--16305 \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 16305--16305 \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 16305--16305 \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 16305--16305 []\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 16305--16305 \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 16305--16305 [][]\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 16305--16305 \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 16305--16305 \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 16305--16305 [][]\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 16305--16305 [][]\T1/cmtt/m/n/10 The template " crpix%1d" will match keywords consisting of " CRPIX" followed by [277] Overfull \hbox (0.10988pt too wide) in paragraph at lines 16305--16305 [][]\T1/cmtt/m/n/10 The template " P%c" will match any keyword starting with " P" and followed by [278] Overfull \hbox (29.35176pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 will, in some sense, represent the " closest" non-virtual coord inate system to [279] Overfull \hbox (10.86975pt too wide) in paragraph at lines 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 it represents. Otherwise, a null []Object[] pointer (AST__NULL) is returned without error. [280] Overfull \hbox (27.71973pt too wide) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 []\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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 domain " PIXEL" . If this also fails, then any 2-dimensional co ordinate system [281] Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 []\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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 []\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 16700--16700 \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 16700--16700 Underfull \hbox (badness 10000) in paragraph at lines 16700--16700 [] \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 [][]\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 16700--16700 []\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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 A successful match by the template depends on a number of crite ria, as outlined below: [282] Overfull \hbox (5.62103pt too wide) in paragraph at lines 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 [][]\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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \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 16700--16700 \T1/cmtt/m/n/10 behaviour). You should consult the descriptions of these attrib utes for details [283] [284] Overfull \hbox (8.09445pt too wide) in paragraph at lines 16876--16876 []\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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 16876--16876 \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 16876--16876 \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 16876--16876 \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 16876--16876 [] \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 16876--16876 \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 16876--16876 \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 16876--16876 []\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 16876--16876 [][]\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 16876--16876 [][]\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 16876--16876 []\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 16876--16876 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [285] Overfull \hbox (17.69308pt too wide) in paragraph at lines 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 \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 16955--16955 [] \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 16955--16955 \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 16955--16955 \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 16955--16955 [][]\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 16955--16955 []\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 16955--16955 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [286] Overfull \hbox (26.51622pt too wide) in paragraph at lines 17053--17053 []\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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 [] \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 17053--17053 \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 17053--17053 \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 17053--17053 [][]\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 17053--17053 \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 17053--17053 \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 17053--17053 \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 17053--17053 \T1/cmtt/m/n/10 positions measured in the two systems. In addition, any differe nce in the Unit [287] Overfull \hbox (5.62103pt too wide) in paragraph at lines 17053--17053 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [288] Overfull \hbox (36.8509pt too wide) in paragraph at lines 17116--17116 \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 17116--17116 [][]\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 17116--17116 \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 17116--17116 \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 17116--17116 [][]\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 17116--17116 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [289] Overfull \hbox (15.85603pt too wide) in paragraph at lines 17205--17205 \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 17205--17205 \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 17205--17205 \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 17205--17205 \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 17205--17205 \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 17205--17205 [] \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 17205--17205 \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 17205--17205 \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 17205--17205 Underfull \hbox (badness 10000) in paragraph at lines 17205--17205 [] \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 17205--17205 \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 17205--17205 Underfull \hbox (badness 10000) in paragraph at lines 17205--17205 [] \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 17205--17205 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [290] [291] Overfull \hbox (37.11334pt too wide) in paragraph at lines 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 [] \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 17319--17319 \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 17319--17319 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [292] Overfull \hbox (5.62103pt too wide) in paragraph at lines 17319--17319 [][]\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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 \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 17319--17319 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [293] Overfull \hbox (5.3586pt too wide) in paragraph at lines 17348--17348 \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 17348--17348 \T1/cmtt/m/n/10 Pointer to a new Object created from the supplied serialisation , or NULL if the serialisation [294] Overfull \hbox (10.86975pt too wide) in paragraph at lines 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 \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 17402--17402 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [295] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17484. Overfull \hbox (5.62103pt too wide) in paragraph at lines 17484--17484 \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 17484--17484 \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 17484--17484 \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 17484--17484 Underfull \hbox (badness 10000) in paragraph at lines 17484--17484 Underfull \hbox (badness 10000) in paragraph at lines 17484--17484 [] \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 17484--17484 [][]\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 17484--17484 \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 17484--17484 [][]\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 17484--17484 \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 17484--17484 \T1/cmtt/m/n/10 of this function. After this, the memory containing the string may be re-used, [296] Overfull \hbox (31.86462pt too wide) in paragraph at lines 17522--17522 [][]\T1/cmtt/m/n/10 A zero value will be returned if this function is invoked w ith the AST error status [297] Overfull \hbox (26.09103pt too wide) in paragraph at lines 17565--17565 \T1/cmtt/m/n/10 The index of the cell for which information is required. The fi rst cell has index Overfull \hbox (10.86975pt too wide) in paragraph at lines 17565--17565 \T1/cmtt/m/n/10 zero. An error will be reported if the supplied value is greate r than or equal [298] Overfull \hbox (2.6858pt too wide) in paragraph at lines 17661--17661 []\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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 \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 17661--17661 Overfull \hbox (0.10988pt too wide) in paragraph at lines 17661--17661 [][]\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 17661--17661 \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 17661--17661 \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 17661--17661 \T1/cmtt/m/n/10 astColumNull function. For columns holding string values, the A SCII NULL character [299] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 17821. Overfull \hbox (7.19565pt too wide) in paragraph at lines 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 \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 [300] Overfull \hbox (2.001pt too wide) in paragraph at lines 17821--17821 \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 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 \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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 [][]\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 17821--17821 \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 17821--17821 \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 17821--17821 \T1/cmtt/m/n/10 any trailing spaces) contains 8 or fewer characters. Trailing s paces are not [301] Overfull \hbox (5.3586pt too wide) in paragraph at lines 17873--17873 \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 17873--17873 \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 17873--17873 [][]\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 17873--17873 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [302] Overfull \hbox (2.26344pt too wide) in paragraph at lines 17906--17906 \T1/cmtt/m/n/10 A pointer to the graphics context KeyMap. The returned pointer should be annulled [303] Overfull \hbox (26.35347pt too wide) in paragraph at lines 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 [][]\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 17981--17981 \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 17981--17981 [][]\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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 [][]\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 17981--17981 \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 17981--17981 \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 17981--17981 \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 17981--17981 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [304] Overfull \hbox (0.10988pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 The length of the supplied array in bytes. An error will be rep orted if this Overfull \hbox (0.10988pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 value is smaller than the number required to describe the Moc ( the product of Overfull \hbox (38.68796pt too wide) in paragraph at lines 18028--18028 \T1/cmtt/m/n/10 Pointer to the area of memory in which to return the signed int eger cell identifiers. [305] [306] Overfull \hbox (31.76494pt too wide) in paragraph at lines 18103--18103 []\T1/cmtt/m/n/10 void astGetMocString( AstMoc $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int json, size_t mxsize, char $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 string, size_t $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 size, Overfull \hbox (26.6159pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 If non-zero, the Moc is encoded using JSON serialisation. Other wise it is encoded Overfull \hbox (0.10988pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 The length of the supplied string buffer in bytes. An error wil l be reported Overfull \hbox (13.49411pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 if this value is smaller than the number required to describe t he Moc. However, Overfull \hbox (16.11847pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 if zero is supplied, the buffer will be ignored - no string wil l be returned but Overfull \hbox (68.60565pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 Pointer to the area of memory in which to return the JSON or st ring-encoded representation Overfull \hbox (21.36719pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 of the Moc. This area is assumed to contain at least ' mxsize' bytes. Only used Overfull \hbox (58.10822pt too wide) in paragraph at lines 18103--18103 \T1/cmtt/m/n/10 Returned holding the number of bytes needed to store the comple te JSON or string-encoded [307] Overfull \hbox (7.30714pt too wide) in paragraph at lines 18159--18159 []\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 18159--18159 \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 18159--18159 \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 18159--18159 \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.60732pt too wide) in paragraph at lines 18159--18159 [] \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 18159--18159 [][]\T1/cmtt/m/n/10 Values of AST__BAD will be returned if this function is inv oked with the AST error [308] Overfull \hbox (28.19052pt too wide) in paragraph at lines 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 \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 18219--18219 [][]\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 18219--18219 [][]\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 18219--18219 \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 18219--18219 \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 18219--18219 [][]\T1/cmtt/m/n/10 If the bounds on an axis cannot be determined, AST__BAD is returned for both upper [309] Overfull \hbox (10.86975pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 Pointer to a two-element array in which to return the axis valu es at the centre Overfull \hbox (5.62103pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 Pointer to a variable in which to return the radius of the boun ding disc, as a Overfull \hbox (26.6159pt too wide) in paragraph at lines 18274--18274 \T1/cmtt/m/n/10 geodesic distance within the Frame represented by the Region. I t will be returned Overfull \hbox (26.6159pt too wide) in paragraph at lines 18274--18274 [][]\T1/cmtt/m/n/10 The value of the Negated attribute is ignored (i.e. it is a ssumed that the Region Overfull \hbox (10.86975pt too wide) in paragraph at lines 18274--18274 [][]\T1/cmtt/m/n/10 If the Region is unbounded, the radius will be returned set to AST__BAD and the [310] Overfull \hbox (12.49844pt too wide) in paragraph at lines 18312--18312 \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 18312--18312 \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 18312--18312 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [311] Overfull \hbox (28.2446pt too wide) in paragraph at lines 18353--18353 \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 18353--18353 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [312] Overfull \hbox (12.97206pt too wide) in paragraph at lines 18440--18440 []\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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 [][]\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 18440--18440 \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 18440--18440 \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 18440--18440 \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 18440--18440 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied Overfull \hbox (2.99667pt too wide) in paragraph at lines 18440--18440 [][]\T1/cmtt/m/n/10 If the Region defines an area within a []SkyFrame[] that tr averses zero longitude, Overfull \hbox (42.36206pt too wide) in paragraph at lines 18440--18440 \T1/cmtt/m/n/10 the returned positions will be normalised to avoid jumps of 2.P I radians in longitude [313] Overfull \hbox (32.0758pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \T1/cmtt/m/n/10 rather than an included interval. See the Interval constructor for more information. [314] Overfull \hbox (30.55527pt too wide) in paragraph at lines 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 [][]\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 18589--18589 \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 18589--18589 \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 18589--18589 \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 18589--18589 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [315] Overfull \hbox (0.10988pt too wide) in paragraph at lines 18644--18644 \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 18644--18644 \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 18644--18644 Overfull \hbox (5.62103pt too wide) in paragraph at lines 18644--18644 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [316] Overfull \hbox (13.49411pt too wide) in paragraph at lines 18680--18680 [][]\T1/cmtt/m/n/10 Zero will be returned if this function is invoked with the AST error status set, [317] Overfull \hbox (5.62103pt too wide) in paragraph at lines 18717--18717 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [318] Overfull \hbox (28.19052pt too wide) in paragraph at lines 18760--18760 [][]\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 18760--18760 [][]\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 18760--18760 \T1/cmtt/m/n/10 To modify the FitsTable, the modified FitsChan must be stored i n the FitsTable [319] Overfull \hbox (10.13652pt too wide) in paragraph at lines 18816--18816 \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 18816--18816 \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 18816--18816 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [320] Overfull \hbox (47.34834pt too wide) in paragraph at lines 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 [][]\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 18907--18907 \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 18907--18907 \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 18907--18907 \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 18907--18907 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (NULL) will be returned if this f unction is invoked with [321] Overfull \hbox (5.62103pt too wide) in paragraph at lines 18944--18944 [][]\T1/cmtt/m/n/10 This function returns without action if there are no snapsh ots to restore. No [322] [323] Overfull \hbox (31.60219pt too wide) in paragraph at lines 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \T1/cmtt/m/n/10 the functions listed below should never annul or delete the sup plied KeyMap pointer. [324] Overfull \hbox (18.0096pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \T1/cmtt/m/n/10 return zero, in which case " M" justification will never be req uested by Plot. The [325] Overfull \hbox (2.52588pt too wide) in paragraph at lines 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 []\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 19446--19446 []\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 19446--19446 []\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 19446--19446 []\T1/cmtt/m/n/10 The " Mark" function displays markers at the given positions. It requires the following [326] Overfull \hbox (28.19052pt too wide) in paragraph at lines 19446--19446 [][]\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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\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 19446--19446 []\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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 \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 19446--19446 [][]\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 19446--19446 \T1/cmtt/m/n/10 value should be negated to ensure that positive values always r efer to displacements [327] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19446--19446 [][]\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 19446--19446 \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 19446--19446 []\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 19446--19446 \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 19446--19446 \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 19446--19446 []\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 19446--19446 [][]\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 19446--19446 \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 19446--19446 [][]\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 19446--19446 [][]\T1/cmtt/m/n/10 yb - An array of 4 elements in which to return the y coordi nate of each corner [328] Overfull \hbox (47.61078pt too wide) in paragraph at lines 19491--19491 [][]\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 19491--19491 \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 19491--19491 \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 19491--19491 \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 19491--19491 [][]\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 19491--19491 [][]\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 19491--19491 \T1/cmtt/m/n/10 of the Plot is not defined in either direction (i.e. the Plot' s []TranForward[] [329] Overfull \hbox (15.85603pt too wide) in paragraph at lines 19558--19558 \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 19558--19558 \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 19558--19558 \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 19558--19558 \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 19558--19558 [][]\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 19558--19558 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [330] Overfull \hbox (10.86975pt too wide) in paragraph at lines 19625--19625 \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 19625--19625 \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 19625--19625 \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 19625--19625 [] \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 19625--19625 \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 19625--19625 \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 19625--19625 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [331] Overfull \hbox (10.60732pt too wide) in paragraph at lines 19673--19673 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [332] Overfull \hbox (15.85603pt too wide) in paragraph at lines 19710--19710 \T1/cmtt/m/n/10 The character string holding the upper case name of the column. Trailing spaces [333] Overfull \hbox (31.60219pt too wide) in paragraph at lines 19747--19747 \T1/cmtt/m/n/10 The character string holding the upper case name of the paramet er. Trailing spaces [334] [335] Overfull \hbox (28.71822pt too wide) in paragraph at lines 19867--19867 []\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.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.10475pt too wide) in paragraph at lines 19867--19867 [] \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 19867--19867 \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 19867--19867 \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 19867--19867 [][]\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 19867--19867 \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 19867--19867 [][]\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 19867--19867 \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 19867--19867 [][]\T1/cmtt/m/n/10 The geodesic curve used by this function is the path of sho rtest distance between [336] Overfull \hbox (10.55888pt too wide) in paragraph at lines 20000--20000 []\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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 []\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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 []\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 20000--20000 \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 20000--20000 \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 20000--20000 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 20000--20000 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [337] Overfull \hbox (10.86975pt too wide) in paragraph at lines 20000--20000 \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 20000--20000 \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 20000--20000 \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 20000--20000 [] \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 20000--20000 \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 20000--20000 \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 20000--20000 [][]\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 20000--20000 []\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 20000--20000 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [338] Overfull \hbox (5.52135pt too wide) in paragraph at lines 20092--20092 []\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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 \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 20092--20092 [] \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 20092--20092 \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 20092--20092 \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 20092--20092 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [339] [340] Overfull \hbox (5.78378pt too wide) in paragraph at lines 20275--20275 []\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \T1/cmtt/m/n/10 external user who does not have access to the function, then th ese contact details [341] Overfull \hbox (10.86975pt too wide) in paragraph at lines 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 []\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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 20275--20275 \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 20275--20275 \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 20275--20275 \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 20275--20275 [][]\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 20275--20275 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 20275--20275 \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 20275--20275 \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 20275--20275 \T1/cmtt/m/n/10 if it is encountered while simplifying a compound Mapping (e.g. using astSimplify). [342] [343] [344] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 20363. Overfull \hbox (3.47949pt too wide) in paragraph at lines 20363--20363 \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 20363--20363 Underfull \hbox (badness 10000) in paragraph at lines 20363--20363 [] \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 20363--20363 [][]\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 20363--20363 [][]\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 20363--20363 \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 20363--20363 [][]\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 20363--20363 \T1/cmtt/m/n/10 particular, it will fail if the pointer supplied does not ident ify an Object of [345] Overfull \hbox (10.86975pt too wide) in paragraph at lines 20438--20438 \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 20438--20438 \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 20438--20438 \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 20438--20438 [] \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 20438--20438 \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 20438--20438 \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 20438--20438 [][]\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 20438--20438 []\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 20438--20438 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [346] Overfull \hbox (18.90558pt too wide) in paragraph at lines 20556--20556 []\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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.10475pt too wide) in paragraph at lines 20556--20556 [] \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 [] \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 [][]\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 20556--20556 \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 20556--20556 [][]\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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \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 20556--20556 \T1/cmtt/m/n/10 If all Mapping outputs generate bad values, then zero is return ed as the function [347] Overfull \hbox (26.35347pt too wide) in paragraph at lines 20556--20556 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error Overfull \hbox (2.99667pt too wide) in paragraph at lines 20556--20556 [][]\T1/cmtt/m/n/10 If all tested positions within the supplied box generate ba d output positions, Overfull \hbox (26.6159pt too wide) in paragraph at lines 20556--20556 \T1/cmtt/m/n/10 then the returned function value will be zero. However, the ret urned coefficients Overfull \hbox (31.60219pt too wide) in paragraph at lines 20556--20556 \T1/cmtt/m/n/10 will represent a unit transformation, except that the constant term for each output [348] Overfull \hbox (21.10475pt too wide) in paragraph at lines 20634--20634 \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 20634--20634 \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 20634--20634 \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 20634--20634 \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 20634--20634 [][]\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 20634--20634 \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 20634--20634 [][]\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 20634--20634 [][]\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 20634--20634 \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 20634--20634 \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 20634--20634 \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 20634--20634 [][]\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 20634--20634 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [349] Overfull \hbox (7.72334pt too wide) in paragraph at lines 20745--20745 []\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 (5.3586pt too wide) in paragraph at lines 20745--20745 \T1/cmtt/m/n/10 The input coordinate value which corresponds to the centre of t he first lookup Overfull \hbox (36.8509pt too wide) in paragraph at lines 20745--20745 \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 20745--20745 \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 20745--20745 \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 20745--20745 \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 20745--20745 \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 20745--20745 [] \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 20745--20745 \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 20745--20745 \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 20745--20745 [][]\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 20745--20745 \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 20745--20745 \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 20745--20745 \T1/cmtt/m/n/10 of zero, so that any attempt to use the inverse transformation will result in [350] Overfull \hbox (5.62103pt too wide) in paragraph at lines 20745--20745 [][]\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 20745--20745 []\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 20745--20745 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [351] Overfull \hbox (18.22078pt too wide) in paragraph at lines 20888--20888 []\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 []\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 20888--20888 \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 20888--20888 \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 20888--20888 []\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.35347pt too wide) in paragraph at lines 20888--20888 [] \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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [352] Overfull \hbox (26.35347pt too wide) in paragraph at lines 20888--20888 [] \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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 \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 20888--20888 [][]\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 20888--20888 \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 20888--20888 \T1/cmtt/m/n/10 values on entry will not be altered if the function is invoked with the AST error [353] Overfull \hbox (31.86462pt too wide) in paragraph at lines 20934--20934 [][]\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 20934--20934 [][]\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 20934--20934 \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 20934--20934 \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 20934--20934 \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 20934--20934 [][]\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 20934--20934 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [354] Overfull \hbox (2.89699pt too wide) in paragraph at lines 20998--20998 []\T1/cmtt/m/n/10 void astMapCopyEntry( AstKeyMap $\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 key, AstKeyMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 that, int merge Overfull \hbox (0.10988pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 The character string identifying the value to be copied. Traili ng spaces are Overfull \hbox (26.6159pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] Overfull \hbox (5.62103pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 Indicates what to do if the named entry holds a KeyMap and a Ke yMap entry with Overfull \hbox (0.37231pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 the same key already exists in the destination KeyMap. If zero, the existing Overfull \hbox (7.19565pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 destination KeyMap will be deleted and replaced by a copy of th e source KeyMap. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20998--20998 \T1/cmtt/m/n/10 If non-zero, all entries in the source KeyMap will be copied in to the existing Overfull \hbox (31.86462pt too wide) in paragraph at lines 20998--20998 [][]\T1/cmtt/m/n/10 This fuction returns without action if the named entry does not exist in the source Overfull \hbox (31.86462pt too wide) in paragraph at lines 20998--20998 [][]\T1/cmtt/m/n/10 Entries from the source KeyMap will replace any existing en tries in the destination Overfull \hbox (10.86975pt too wide) in paragraph at lines 20998--20998 [][]\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 20998--20998 \T1/cmtt/m/n/10 an error will be reported if the source KeyMap contains any key s that do not already [355] Overfull \hbox (15.85603pt too wide) in paragraph at lines 21036--21036 \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 21036--21036 \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 21036--21036 \T1/cmtt/m/n/10 A non-zero value is returned if the requested key name is prese nt in the KeyMap and [356] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21166. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 [][]\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 21166--21166 \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 21166--21166 [][]\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 21166--21166 [][]\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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 \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 21166--21166 [][]\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 21166--21166 \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 21166--21166 \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 21166--21166 \T1/cmtt/m/n/10 Object. The returned pointer should be annulled using []astAnnu l[] when it is no [357] Overfull \hbox (8.46577pt too wide) in paragraph at lines 21166--21166 []\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 21166--21166 \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 21166--21166 \T1/cmtt/m/n/10 For example, astMapGet0D would be used to get a " double" value , while astMapGet0I [358] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21314. Overfull \hbox (15.56409pt too wide) in paragraph at lines 21314--21314 []\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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the Overfull \hbox (5.62103pt too wide) in paragraph at lines 21314--21314 \T1/cmtt/m/n/10 " value" array. Any unused elements of the array are left uncha nged. Zero is Overfull \hbox (15.85603pt too wide) in paragraph at lines 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 [][]\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 21314--21314 \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 21314--21314 [][]\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 21314--21314 []\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 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 when invoking astMapGet1C, and should include space for a termi nating null character. [359] Overfull \hbox (8.46577pt too wide) in paragraph at lines 21314--21314 []\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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \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 21314--21314 \T1/cmtt/m/n/10 For A, the supplied " value" parameter should be a pointer to a n array of AstObject [360] Overfull \hbox (15.85603pt too wide) in paragraph at lines 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 [][]\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 21384--21384 \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 21384--21384 [][]\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 21384--21384 \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 21384--21384 \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 21384--21384 \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 21384--21384 \T1/cmtt/m/n/10 than this. The calling code should never attempt to free the re turned pointer [361] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21518. Overfull \hbox (5.06665pt too wide) in paragraph at lines 21518--21518 []\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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 [][]\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 21518--21518 \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 21518--21518 []\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 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 []\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 21518--21518 \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 [362] Overfull \hbox (34.01819pt too wide) in paragraph at lines 21518--21518 \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 21518--21518 \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 21518--21518 \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 21518--21518 \T1/cmtt/m/n/10 be a pointer to a character string with " l" elements. For A, t he supplied " value" [363] Overfull \hbox (12.18193pt too wide) in paragraph at lines 21570--21570 \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 21570--21570 \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 21570--21570 [][]\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 21570--21570 \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 21570--21570 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [364] Overfull \hbox (26.09103pt too wide) in paragraph at lines 21630--21630 \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 21630--21630 \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 21630--21630 [][]\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 21630--21630 \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 21630--21630 \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 21630--21630 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [365] Overfull \hbox (12.18193pt too wide) in paragraph at lines 21682--21682 \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 21682--21682 \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 21682--21682 \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 21682--21682 [][]\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 21682--21682 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [366] Overfull \hbox (12.18193pt too wide) in paragraph at lines 21727--21727 \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 21727--21727 \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 21727--21727 \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 21727--21727 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [367] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21840. Overfull \hbox (46.79396pt too wide) in paragraph at lines 21840--21840 []\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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 [][]\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 21840--21840 [][]\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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 \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 21840--21840 []\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 21840--21840 \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 [368] Overfull \hbox (13.02332pt too wide) in paragraph at lines 21840--21840 \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 21840--21840 []\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 [369] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 21947. Overfull \hbox (33.46098pt too wide) in paragraph at lines 21947--21947 []\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 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 \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 21947--21947 [][]\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 21947--21947 []\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 21947--21947 \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 21947--21947 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I [370] Overfull \hbox (7.98578pt too wide) in paragraph at lines 21947--21947 []\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 [371] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22075. Overfull \hbox (4.59303pt too wide) in paragraph at lines 22075--22075 []\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 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 [][]\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 22075--22075 [][]\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 22075--22075 \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 22075--22075 []\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 22075--22075 \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 [372] Overfull \hbox (34.01819pt too wide) in paragraph at lines 22075--22075 \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 22075--22075 \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 22075--22075 \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 22075--22075 \T1/cmtt/m/n/10 to a character string. For A, the supplied " value" parameter s hould be an AstObject [373] Overfull \hbox (31.33975pt too wide) in paragraph at lines 22125--22125 \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 22125--22125 \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 22125--22125 \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 22125--22125 [][]\T1/cmtt/m/n/10 If the supplied key is already in use in the KeyMap, the va lue associated with [374] Overfull \hbox (47.61078pt too wide) in paragraph at lines 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 \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 22193--22193 [][]\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 22193--22193 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [375] Overfull \hbox (15.85603pt too wide) in paragraph at lines 22222--22222 \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 22222--22222 \T1/cmtt/m/n/10 ignored. The supplied string is converted to upper case before use if the []KeyCase[] [376] Overfull \hbox (5.3586pt too wide) in paragraph at lines 22259--22259 \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 22259--22259 \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 22259--22259 \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 22259--22259 \T1/cmtt/m/n/10 are ignored. The supplied string is converted to upper case bef ore use if the [377] Overfull \hbox (5.3586pt too wide) in paragraph at lines 22293--22293 [][]\T1/cmtt/m/n/10 A function value of zero will be returned if an error has a lready occurred, or [378] Overfull \hbox (24.31422pt too wide) in paragraph at lines 22376--22376 []\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 22376--22376 [] \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 \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 22376--22376 [][]\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 22376--22376 \T1/cmtt/m/n/10 fail for any reason, then a NULL value will be returned for the " map" pointer. [379] Overfull \hbox (12.18193pt too wide) in paragraph at lines 22437--22437 \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 22437--22437 \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 22437--22437 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__KINTTYPE (for Overfull \hbox (79.10309pt too wide) in paragraph at lines 22437--22437 [][]\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 22437--22437 \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 22437--22437 \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 22437--22437 \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 22437--22437 [][]\T1/cmtt/m/n/10 A function value of AST__BADTYPE will be returned if an err or has already occurred, [380] Overfull \hbox (13.18324pt too wide) in paragraph at lines 22523--22523 []\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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.09962pt too wide) in paragraph at lines 22523--22523 [] \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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 \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 22523--22523 [][]\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 22523--22523 \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 22523--22523 [][]\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 22523--22523 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [381] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 22740. Overfull \hbox (3.90186pt too wide) in paragraph at lines 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim" elements, contain ing the coordinates [382] Overfull \hbox (0.37231pt too wide) in paragraph at lines 22740--22740 []\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 22740--22740 \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 22740--22740 \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 22740--22740 \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 22740--22740 [] \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 22740--22740 \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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 []\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 22740--22740 \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 22740--22740 [][]\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 22740--22740 [][]\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 22740--22740 []\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 22740--22740 \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 22740--22740 \T1/cmtt/m/n/10 For example, astMaskD would be used to process " double" data, while astMaskS would Overfull \hbox (28.76947pt too wide) in paragraph at lines 22740--22740 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (13.02332pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" and " ubnd" are changed fro m type " int" to type Overfull \hbox (12.76088pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 " int64_t" (defined in header file stdint.h). The function retu rn type is similarly Overfull \hbox (2.52588pt too wide) in paragraph at lines 22740--22740 \T1/cmtt/m/n/10 changed to type int64_t. The function name is changed by insert ing the digit " 8" [383] [384] Overfull \hbox (5.62103pt too wide) in paragraph at lines 22802--22802 \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 22802--22802 \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 22802--22802 \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 22802--22802 []\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 22802--22802 [][]\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 22802--22802 \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 22802--22802 \T1/cmtt/m/n/10 identical. For instance, []SkyFrame[] axes in two Frames will m atch even if they [385] Overfull \hbox (28.9294pt too wide) in paragraph at lines 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [] \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [386] Overfull \hbox (16.11847pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 undefined, you must supply dummy expressions which simply name each of the output (or [387] Overfull \hbox (2.52588pt too wide) in paragraph at lines 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 performed by MathMap transformations. The special value AST__BA D can be represented [388] Overfull \hbox (29.46065pt too wide) in paragraph at lines 23539--23539 []\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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 []\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 23539--23539 \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 23539--23539 [][]\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 23539--23539 [][]\T1/cmtt/m/n/10 x1 != x2: Tests whether " x1" is unequal to " x2" . (The sy nonym " .ne." is [389] Overfull \hbox (8.7222pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 []\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 \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 23539--23539 \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 23539--23539 \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 23539--23539 \T1/cmtt/m/n/10 point are also inverted. To invert only those bits to the left of the binary point, [390] Overfull \hbox (22.9418pt too wide) in paragraph at lines 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\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 23539--23539 [][]\T1/cmtt/m/n/10 sign(x1, x2): Absolute value of " x1" with the sign of " x2 " (transfer of sign). [391] Overfull \hbox (3.21706pt too wide) in paragraph at lines 23539--23539 []\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 23539--23539 [][]$\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 23539--23539 \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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 [][]$\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 23539--23539 \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 23539--23539 \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 23539--23539 []\T1/cmtt/m/n/10 Items appearing in expressions are evaluated in the following order (highest precedence [392] Overfull \hbox (26.35948pt too wide) in paragraph at lines 23539--23539 \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 [393] Overfull \hbox (18.22078pt too wide) in paragraph at lines 23660--23660 []\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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 []\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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 [] \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 23660--23660 \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 23660--23660 \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 23660--23660 [][]\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 23660--23660 \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 23660--23660 \T1/cmtt/m/n/10 attribute) will only be available if the associated matrix is s quare and non-singular. [394] Overfull \hbox (21.36719pt too wide) in paragraph at lines 23660--23660 [][]\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 23660--23660 \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 23660--23660 \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 23660--23660 \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 23660--23660 [][]\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 23660--23660 []\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 23660--23660 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [395] Overfull \hbox (21.10475pt too wide) in paragraph at lines 23733--23733 \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 23733--23733 \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 23733--23733 \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 23733--23733 \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 23733--23733 [][]\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 23733--23733 \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 23733--23733 [][]\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 23733--23733 \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 23733--23733 [][]\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 23733--23733 [][]\T1/cmtt/m/n/10 Any variant Mappings explicitly added to the current Frame using astAddVariant [396] Underfull \hbox (badness 10000) in paragraph at lines 23832--23832 Overfull \hbox (10.86975pt too wide) in paragraph at lines 23832--23832 \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 23832--23832 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Mo c. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23832--23832 \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 23832--23832 [] \T1/cmtt/m/n/10 If the " options" string contains " %" format specifiers, then an optional list Overfull \hbox (26.6159pt too wide) in paragraph at lines 23832--23832 \T1/cmtt/m/n/10 of additional parameters may follow it in order to supply value s to be substituted Overfull \hbox (10.60732pt too wide) in paragraph at lines 23832--23832 \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 23832--23832 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [397] Overfull \hbox (2.26344pt too wide) in paragraph at lines 23832--23832 []\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 23832--23832 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [398] Overfull \hbox (8.56807pt too wide) in paragraph at lines 23939--23939 []\T1/cmtt/m/n/10 AstMocChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astMocChan( 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 23939--23939 \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 this function will be used by the MocChan to obtain lines of in put text. On each Overfull \hbox (42.36206pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 []\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 23939--23939 \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 this function will be used by the MocChan to deliver lines of o utput text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 []\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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Mo cChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 23939--23939 \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 23939--23939 [] \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 23939--23939 \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 23939--23939 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [399] Overfull \hbox (8.24539pt too wide) in paragraph at lines 23939--23939 [][]\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 23939--23939 \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 23939--23939 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [400] [401] Overfull \hbox (49.9727pt too wide) in paragraph at lines 24019--24019 \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 24019--24019 \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 24019--24019 \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 24019--24019 \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 24019--24019 [][]\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 24019--24019 \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 24019--24019 \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 24019--24019 [][]\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 24019--24019 [][]\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 24019--24019 \T1/cmtt/m/n/10 for display by using this function to normalise them, followed by appropriate [402] Overfull \hbox (17.43065pt too wide) in paragraph at lines 24099--24099 \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 24099--24099 \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 24099--24099 \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 24099--24099 \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 24099--24099 [] \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 24099--24099 \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 24099--24099 \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 24099--24099 [][]\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 24099--24099 []\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 24099--24099 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [403] Overfull \hbox (23.4695pt too wide) in paragraph at lines 24225--24225 []\T1/cmtt/m/n/10 void astNormPoints( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m /n/10 this, int npoint, int ncoord_in, int indim, const double Overfull \hbox (5.3586pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 The number of coordinates being supplied for each input point. This should be Overfull \hbox (36.8509pt too wide) in paragraph at lines 24225--24225 \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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (57.84578pt too wide) in paragraph at lines 24225--24225 [] \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of shape " [ncoord_in][indim]" Overfull \hbox (5.62103pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 , containing the coordinates of the input (unnormalised) points . These should Overfull \hbox (26.35347pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be stored such that the value of coordinate number " coord" for input point number Overfull \hbox (5.3586pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 Indicates the way in which the normalised axis values are to be calculated. A Overfull \hbox (16.11847pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 non-zero value causes the values to be normalised in such a way as to reduce the Overfull \hbox (5.62103pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 effects of any discontinuities in the coordinate system. For in stance, points Overfull \hbox (16.11847pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 in a []SkyFrame[] that span longitude zero will be normalized i nto a longitude range Overfull \hbox (13.70848pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 of -pi to $\OT1/zplm/m/n/10 +$\T1/cmtt/m/n/10 pi (otherwise the y will be normalized into a range of 0 to 2.pi). A Overfull \hbox (10.60732pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 The number of coordinates being supplied for each output point. This should be Overfull \hbox (21.10475pt too wide) in paragraph at lines 24225--24225 \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 24225--24225 \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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 The address of the first element in a 2-dimensional array of sh ape " [ncoord_out][outdim]" Overfull \hbox (7.19565pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 , into which the coordinates of the output (normalised) points will be written. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [404] Overfull \hbox (42.36206pt too wide) in paragraph at lines 24225--24225 [][]\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 24225--24225 \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 24225--24225 \T1/cmtt/m/n/10 cyclic quantities (such as angles or positions on the sky), coo rdinates will typically Overfull \hbox (0.5835pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be wrapped into an appropriate standard range, such as zero to 2$\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 pi or -pi to Overfull \hbox (44.51563pt too wide) in paragraph at lines 24225--24225 []\T1/cmtt/m/n/10 If the number of points to be normalised exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (13.02332pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 Specifically, the arguments " npoint" , " indim" and " outdim" are changed from type Overfull \hbox (2.52588pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 " int" to type " int64_t" (defined in header file stdint.h). Th e function name is Overfull \hbox (55.01306pt too wide) in paragraph at lines 24225--24225 \T1/cmtt/m/n/10 changed by appending the digit " 8" to the name. Thus, astNormP oints becomes astNormPoints8 Underfull \hbox (badness 10000) in paragraph at lines 24225--24225 [405] Overfull \hbox (5.73253pt too wide) in paragraph at lines 24310--24310 []\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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 []\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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 \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 24310--24310 [] \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 24310--24310 \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 24310--24310 \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 24310--24310 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [406] Overfull \hbox (42.36206pt too wide) in paragraph at lines 24343--24343 [][]\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 24343--24343 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [407] Overfull \hbox (12.97206pt too wide) in paragraph at lines 24419--24419 []\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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 \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 24419--24419 [][]\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 24419--24419 [][]\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 24419--24419 [][]\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 24419--24419 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [408] Overfull \hbox (26.3563pt too wide) in paragraph at lines 24505--24505 []\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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 \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 24505--24505 [][]\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 24505--24505 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [409] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 24790. Overfull \hbox (10.58418pt too wide) in paragraph at lines 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [410] Overfull \hbox (0.37231pt too wide) in paragraph at lines 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 []\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 \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 [411] Overfull \hbox (26.6159pt too wide) in paragraph at lines 24790--24790 [][]\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 24790--24790 [][]\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 24790--24790 \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 24790--24790 \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 24790--24790 \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 24790--24790 [][]\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 24790--24790 []\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 24790--24790 \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 24790--24790 \T1/cmtt/m/n/10 For example, astOutlineD would be used to process " double" dat a, while astOutlineS Overfull \hbox (28.76947pt too wide) in paragraph at lines 24790--24790 []\T1/cmtt/m/n/10 If the input grid is so large that an integer pixel index, (o r a count of pixels) could Overfull \hbox (44.51563pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 exceed the largest value that can be represented by a 4-byte in teger, then the alternative Overfull \hbox (23.52075pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 " 8-byte" interface for this function should be used. This alte rnative interface uses Overfull \hbox (9.34921pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 8 byte integer arguments (instead of 4-byte) to hold pixel indi ces and pixel counts. Overfull \hbox (7.7746pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 Specifically, the arguments " lbnd" , " ubnd" and " inside" are changed from type " Overfull \hbox (34.01819pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 int" to type " int64_t" (defined in header file stdint.h). The function name is changed Overfull \hbox (19.22565pt too wide) in paragraph at lines 24790--24790 \T1/cmtt/m/n/10 by inserting the digit " 8" before the trailing data type code. Thus, astOutline$\OML/zplm/m/it/10 <$\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$ [412] Overfull \hbox (12.76088pt too wide) in paragraph at lines 24856--24856 \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 24856--24856 []\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 24856--24856 []\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 24856--24856 [][]\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 24856--24856 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [413] Overfull \hbox (5.3586pt too wide) in paragraph at lines 24917--24917 \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 24917--24917 [][]\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 24917--24917 \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 24917--24917 \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 24917--24917 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [414] Overfull \hbox (9.50914pt too wide) in paragraph at lines 25020--25020 []\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 25020--25020 \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 25020--25020 \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 25020--25020 \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 25020--25020 \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 25020--25020 [] \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 25020--25020 \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 25020--25020 \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 25020--25020 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [415] Overfull \hbox (2.26344pt too wide) in paragraph at lines 25020--25020 []\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 25020--25020 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [416] Overfull \hbox (0.10988pt too wide) in paragraph at lines 25059--25059 \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 25059--25059 \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 25059--25059 [][]\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 25059--25059 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [417] Overfull \hbox (5.09898pt too wide) in paragraph at lines 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 []\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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 []\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 25197--25197 \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 25197--25197 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [418] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25197--25197 \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 25197--25197 \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 25197--25197 \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 25197--25197 [] \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 25197--25197 \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 25197--25197 \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 25197--25197 [][]\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 25197--25197 \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 25197--25197 [][]\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 25197--25197 \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 25197--25197 \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 25197--25197 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [419] Overfull \hbox (13.6056pt too wide) in paragraph at lines 25309--25309 []\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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 []\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 25309--25309 Overfull \hbox (23.25832pt too wide) in paragraph at lines 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \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 25309--25309 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [420] Overfull \hbox (26.6159pt too wide) in paragraph at lines 25309--25309 [][]\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 25309--25309 \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 25309--25309 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [421] Overfull \hbox (7.93452pt too wide) in paragraph at lines 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 []\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 25482--25482 \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 25482--25482 \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 25482--25482 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [422] Overfull \hbox (5.3586pt too wide) in paragraph at lines 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [] \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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 \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 25482--25482 [][]\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 25482--25482 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [423] Overfull \hbox (28.9294pt too wide) in paragraph at lines 25618--25618 []\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 []\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 []\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [] \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 25618--25618 \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 25618--25618 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [424] Overfull \hbox (0.10988pt too wide) in paragraph at lines 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 25618--25618 [][]\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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 \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 25618--25618 [][]\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 25618--25618 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [425] Overfull \hbox (26.35347pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 Pointer to an array holding the axis values of the point to be tested. The number Overfull \hbox (7.19565pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 of values in this array should match the number of axes in the supplied Region. Underfull \hbox (badness 10000) in paragraph at lines 25675--25675 Overfull \hbox (5.62103pt too wide) in paragraph at lines 25675--25675 [][]\T1/cmtt/m/n/10 If many points need to be tested, then it is usually more e fficient to use the Overfull \hbox (10.86975pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 Region as a []Mapping[] to transform all the points. This can b e done using one of Overfull \hbox (6.57465pt too wide) in paragraph at lines 25675--25675 \T1/cmtt/m/n/10 the Mapping transformation methods (astTran$\OML/zplm/m/it/10 < $\T1/cmtt/m/n/10 X$\OML/zplm/m/it/10 >$\T1/cmtt/m/n/10 ). If a transformed axis value [426] Overfull \hbox (34.17812pt too wide) in paragraph at lines 25808--25808 []\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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 []\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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 []\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 25808--25808 \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 25808--25808 \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 25808--25808 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 25808--25808 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [427] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25808--25808 \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 25808--25808 \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 25808--25808 \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 25808--25808 [] \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 25808--25808 \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 25808--25808 \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 25808--25808 [][]\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 25808--25808 []\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 25808--25808 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [428] Overfull \hbox (29.14058pt too wide) in paragraph at lines 25885--25885 []\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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 \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 25885--25885 []\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 25885--25885 \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 25885--25885 \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 25885--25885 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [429] Overfull \hbox (18.43196pt too wide) in paragraph at lines 25962--25962 []\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 25962--25962 \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 25962--25962 \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 25962--25962 \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 25962--25962 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.09962pt too wide) in paragraph at lines 25962--25962 [] \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 25962--25962 \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 25962--25962 \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 25962--25962 \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 25962--25962 [][]\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 25962--25962 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [430] Overfull \hbox (12.97206pt too wide) in paragraph at lines 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 []\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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [431] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26089--26089 \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 26089--26089 \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 26089--26089 \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 26089--26089 [] \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 26089--26089 \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 26089--26089 \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 26089--26089 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [432] Overfull \hbox (31.86462pt too wide) in paragraph at lines 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [433] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 \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 26264--26264 [][]\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 26264--26264 \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 26264--26264 \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 26264--26264 [][]\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 26264--26264 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [434] Overfull \hbox (50.13545pt too wide) in paragraph at lines 26409--26409 []\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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 []\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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [435] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26409--26409 []\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 26409--26409 \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 26409--26409 \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 26409--26409 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 \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 26409--26409 [] \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 26409--26409 \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 26409--26409 \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 26409--26409 [][]\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 26409--26409 []\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 26409--26409 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [436] Overfull \hbox (9.9315pt too wide) in paragraph at lines 26488--26488 []\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 26488--26488 \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 26488--26488 \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 26488--26488 \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 26488--26488 [] \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 26488--26488 \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 26488--26488 \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 26488--26488 [][]\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 26488--26488 \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 26488--26488 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [437] [438] [439] Overfull \hbox (0.37231pt too wide) in paragraph at lines 26576--26576 \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 26576--26576 \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 26576--26576 \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 26576--26576 \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 26576--26576 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [440] Overfull \hbox (47.34834pt too wide) in paragraph at lines 26620--26620 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [441] Overfull \hbox (15.8076pt too wide) in paragraph at lines 26678--26678 []\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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [442] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 \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 26731--26731 [][]\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 26731--26731 \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 26731--26731 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [443] Overfull \hbox (52.8595pt too wide) in paragraph at lines 26785--26785 \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 26785--26785 \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 26785--26785 \T1/cmtt/m/n/10 A deep copy of the FitsTable is stored in the FitsChan, so any subsequent changes [444] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26831--26831 \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 26831--26831 \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 26831--26831 \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 26831--26831 [][]\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 26831--26831 [][]\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 26831--26831 \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 26831--26831 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [445] Overfull \hbox (26.6159pt too wide) in paragraph at lines 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 \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 26889--26889 [][]\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 26889--26889 [][]\T1/cmtt/m/n/10 The []astPutTable[] method provides a simpler means of addi ng a single table to a [446] Overfull \hbox (15.85886pt too wide) in paragraph at lines 27004--27004 []\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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.10988pt too wide) in paragraph at lines 27004--27004 [] \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 27004--27004 \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.3586pt too wide) in paragraph at lines 27004--27004 [] \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 27004--27004 \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 27004--27004 [] \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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 []\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 27004--27004 \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 27004--27004 \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 27004--27004 \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 27004--27004 [][]\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 27004--27004 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using []astInver t[] before invoking [447] Overfull \hbox (26.35347pt too wide) in paragraph at lines 27004--27004 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [448] Overfull \hbox (21.10475pt too wide) in paragraph at lines 27073--27073 [] \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 27073--27073 \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 27073--27073 \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 27073--27073 \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 27073--27073 \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 27073--27073 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [449] Overfull \hbox (4.4716pt too wide) in paragraph at lines 27173--27173 []\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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 \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 27173--27173 [] \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 27173--27173 \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 27173--27173 \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 27173--27173 [][]\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 27173--27173 \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 27173--27173 \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 27173--27173 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [450] Overfull \hbox (5.62103pt too wide) in paragraph at lines 27173--27173 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [451] Overfull \hbox (18.0096pt too wide) in paragraph at lines 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 \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 27241--27241 [][]\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 27241--27241 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [452] Overfull \hbox (0.37231pt too wide) in paragraph at lines 27283--27283 [][]\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 27283--27283 [][]\T1/cmtt/m/n/10 The []SourceFile[] attribute is ignored by this function. N ew cards are read from [453] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 27806. Overfull \hbox (6.0526pt too wide) in paragraph at lines 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 > $ [454] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 [] \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [455] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (15.85603pt too wide) in paragraph at lines 27806--27806 [] \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [456] Overfull \hbox (47.61078pt too wide) in paragraph at lines 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [457] Overfull \hbox (41.17413pt too wide) in paragraph at lines 27806--27806 []\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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 \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 27806--27806 [][]\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [458] Overfull \hbox (10.86975pt too wide) in paragraph at lines 27806--27806 [][]\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 27806--27806 \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 27806--27806 \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 27806--27806 \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 27806--27806 []\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 27806--27806 \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 27806--27806 []\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 27806--27806 []\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 27806--27806 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 27806--27806 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [459] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 28408. Overfull \hbox (21.79875pt too wide) in paragraph at lines 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [460] Overfull \hbox (5.3586pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [] \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [461] Overfull \hbox (15.85603pt too wide) in paragraph at lines 28408--28408 [] \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [462] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 \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 [463] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [464] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 [][]\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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 \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 28408--28408 []\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 28408--28408 []\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 28408--28408 []\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 28408--28408 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [465] Overfull \hbox (7.51216pt too wide) in paragraph at lines 28408--28408 []\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 28408--28408 []\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 28408--28408 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 28408--28408 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [466] [467] Overfull \hbox (0.10988pt too wide) in paragraph at lines 28511--28511 \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 28511--28511 \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 28511--28511 \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 28511--28511 \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 28511--28511 [][]\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 28511--28511 [][]\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 28511--28511 \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 28511--28511 [][]\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 28511--28511 \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 28511--28511 [][]\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 28511--28511 \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 28511--28511 [][]\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 28511--28511 \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 28511--28511 [][]\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 28511--28511 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [468] Overfull \hbox (17.43065pt too wide) in paragraph at lines 28540--28540 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [469] Overfull \hbox (15.85603pt too wide) in paragraph at lines 28599--28599 \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 28599--28599 \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 28599--28599 [][]\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 28599--28599 \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 28599--28599 [][]\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 28599--28599 [][]\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 28599--28599 [][]\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 28599--28599 \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 28599--28599 [][]\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 28599--28599 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [470] Overfull \hbox (33.1768pt too wide) in paragraph at lines 28628--28628 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [471] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28711--28711 \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 28711--28711 \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 28711--28711 \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 28711--28711 \T1/cmtt/m/n/10 any Frames which are instances of the Region class are replaced by the equivalent Frame. Overfull \hbox (25.09537pt too wide) in paragraph at lines 28711--28711 \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 28711--28711 [][]\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 28711--28711 \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 28711--28711 [][]\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 28711--28711 \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 28711--28711 \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 28711--28711 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [472] [473] Overfull \hbox (21.10475pt too wide) in paragraph at lines 28767--28767 \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 28767--28767 \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 28767--28767 [474] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 29615. Overfull \hbox (3.69067pt too wide) in paragraph at lines 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [475] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [] \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [476] Overfull \hbox (52.8595pt too wide) in paragraph at lines 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (15.85603pt too wide) in paragraph at lines 29615--29615 [] \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [477] Overfull \hbox (5.3586pt too wide) in paragraph at lines 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [478] Overfull \hbox (26.35347pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [479] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [480] Overfull \hbox (56.1174pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [481] Overfull \hbox (21.36719pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [482] Overfull \hbox (0.37231pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 []\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 29615--29615 []\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [483] Overfull \hbox (26.6159pt too wide) in paragraph at lines 29615--29615 [][]\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 29615--29615 \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 29615--29615 [][]\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 29615--29615 \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 29615--29615 \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 29615--29615 \T1/cmtt/m/n/10 on entry to this function. The number of such array elements is returned as the function Overfull \hbox (7.7746pt too wide) in paragraph at lines 29615--29615 []\T1/cmtt/m/n/10 If the input or output grid is so large that an integer pixel index, (or a count of Overfull \hbox (5.15024pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 pixels) could exceed the largest value that can be represented by a 4-byte integer, Overfull \hbox (55.01306pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 then the alternative " 8-byte" interface for this function shou ld be used. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd_in" , " ubnd_i n" , " lbnd_out" , " Overfull \hbox (23.52075pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 ubnd_out" , " lbnd" , " ubnd" are changed from type " int" to t ype " int64_t" (defined Overfull \hbox (35.5928pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 in header file stdint.h). The function return type is similarly changed to type int64_t. Overfull \hbox (23.25832pt too wide) in paragraph at lines 29615--29615 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [484] Overfull \hbox (12.97206pt too wide) in paragraph at lines 29697--29697 []\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 29697--29697 \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 29697--29697 \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 29697--29697 \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 29697--29697 \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 29697--29697 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.60732pt too wide) in paragraph at lines 29697--29697 [] \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 29697--29697 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.60732pt too wide) in paragraph at lines 29697--29697 [] \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 29697--29697 \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 29697--29697 [][]\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 29697--29697 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [485] Overfull \hbox (10.86975pt too wide) in paragraph at lines 29738--29738 [][]\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 29738--29738 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the []Card[] attribute exceeds the number of cards in [486] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29789--29789 [][]\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 29789--29789 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [487] Overfull \hbox (23.41824pt too wide) in paragraph at lines 29890--29890 []\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 29890--29890 \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 29890--29890 \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 29890--29890 \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 29890--29890 \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 29890--29890 \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 29890--29890 \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 29890--29890 [] \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 29890--29890 \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 29890--29890 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [488] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29890--29890 [][]\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 29890--29890 \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 29890--29890 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [489] Overfull \hbox (10.86975pt too wide) in paragraph at lines 29996--29996 \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 29996--29996 [] \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 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 29996--29996 Underfull \hbox (badness 10000) in paragraph at lines 29996--29996 [] \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 29996--29996 [][]\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 29996--29996 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [490] Overfull \hbox (42.36206pt too wide) in paragraph at lines 29996--29996 [][]\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 29996--29996 \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 29996--29996 \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 29996--29996 [][]\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 29996--29996 \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 29996--29996 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [491] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30068. Overfull \hbox (26.6159pt too wide) in paragraph at lines 30068--30068 \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 30068--30068 \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 30068--30068 \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 30068--30068 Underfull \hbox (badness 10000) in paragraph at lines 30068--30068 Underfull \hbox (badness 10000) in paragraph at lines 30068--30068 [] \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 30068--30068 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [492] Overfull \hbox (23.25832pt too wide) in paragraph at lines 30194--30194 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [493] Overfull \hbox (28.50703pt too wide) in paragraph at lines 30194--30194 \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 30194--30194 \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 30194--30194 \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 30194--30194 \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 30194--30194 \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 30194--30194 \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 30194--30194 [][]\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 30194--30194 \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 30194--30194 [][]\T1/cmtt/m/n/10 The []astGetActiveUnit[] function can be used to retrieve t he current value of the [494] Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Package hyperref Warning: Token not allowed in a PDF string (Unicode): (hyperref) removing `math shift' on input line 30344. Overfull \hbox (14.82803pt too wide) in paragraph at lines 30344--30344 []\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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [495] Overfull \hbox (26.6159pt too wide) in paragraph at lines 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 \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 30344--30344 [][]\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 30344--30344 [][]\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 30344--30344 [][]\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 30344--30344 \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 30344--30344 [][]\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 30344--30344 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [496] Overfull \hbox (10.60732pt too wide) in paragraph at lines 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 \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 30398--30398 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [497] Overfull \hbox (39.63802pt too wide) in paragraph at lines 30470--30470 []\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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 \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 30470--30470 [][]\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 30470--30470 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [498] Overfull \hbox (5.3586pt too wide) in paragraph at lines 30522--30522 \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 30522--30522 \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 30522--30522 \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 30522--30522 []\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 30522--30522 \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 30522--30522 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [499] Overfull \hbox (5.62103pt too wide) in paragraph at lines 30566--30566 \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 30566--30566 \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 30566--30566 \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 30566--30566 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (15.85603pt too wide) in paragraph at lines 30566--30566 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [500] Overfull \hbox (0.37231pt too wide) in paragraph at lines 30604--30604 [][]\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 30604--30604 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [501] Overfull \hbox (0.37231pt too wide) in paragraph at lines 30646--30646 \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 30646--30646 \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 30646--30646 \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 30646--30646 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [502] Overfull \hbox (9.50914pt too wide) in paragraph at lines 30723--30723 []\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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 \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 30723--30723 [] \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 30723--30723 \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 30723--30723 \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 30723--30723 [][]\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 30723--30723 []\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 30723--30723 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [503] [504] [505] Overfull \hbox (42.09962pt too wide) in paragraph at lines 30811--30811 \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 30811--30811 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [506] Overfull \hbox (44.51563pt too wide) in paragraph at lines 30894--30894 \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 30894--30894 [][]\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 30894--30894 \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 30894--30894 [][]\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 30894--30894 \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 30894--30894 [][]\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 30894--30894 \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 30894--30894 \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 30894--30894 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [507] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 [] \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 31023--31023 \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 31023--31023 \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 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \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 31023--31023 \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 31023--31023 \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 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \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 31023--31023 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [508] Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 31023--31023 \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 31023--31023 [][]\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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 [][]\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 31023--31023 \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 31023--31023 [][]\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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 \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 31023--31023 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [509] Overfull \hbox (5.62103pt too wide) in paragraph at lines 31066--31066 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [510] Overfull \hbox (0.37231pt too wide) in paragraph at lines 31286--31286 [] \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 \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 31286--31286 [][]\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [511] Overfull \hbox (49.23947pt too wide) in paragraph at lines 31286--31286 []\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 []\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 31286--31286 \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 31286--31286 \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 31286--31286 \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 31286--31286 [][]\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 31286--31286 [][]\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 31286--31286 [][]\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 31286--31286 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [512] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31286--31286 \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 31286--31286 \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 31286--31286 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [513] Overfull \hbox (10.60732pt too wide) in paragraph at lines 31366--31366 \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 31366--31366 \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 31366--31366 \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 31366--31366 \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 31366--31366 \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 31366--31366 [] \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 31366--31366 \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 31366--31366 \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 31366--31366 [][]\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 31366--31366 \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 31366--31366 \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 31366--31366 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [514] Overfull \hbox (6.88478pt too wide) in paragraph at lines 31647--31647 []\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 31647--31647 [] \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 Overfull \hbox (37.11334pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 [][]\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 31647--31647 []\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 31647--31647 \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 31647--31647 \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 31647--31647 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [515] Overfull \hbox (5.62103pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [516] Overfull \hbox (33.43924pt too wide) in paragraph at lines 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 [][]\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 31647--31647 \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 31647--31647 \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 31647--31647 \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 31647--31647 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [517] Overfull \hbox (18.64314pt too wide) in paragraph at lines 31732--31732 []\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 31732--31732 \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 31732--31732 \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 31732--31732 \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 31732--31732 \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 31732--31732 \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 31732--31732 \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 31732--31732 [] \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 31732--31732 \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 31732--31732 \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 31732--31732 [][]\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 31732--31732 \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 31732--31732 \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 31732--31732 [][]\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 31732--31732 []\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 31732--31732 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [518] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 [] \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 31832--31832 \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 31832--31832 \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 31832--31832 Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [519] Overfull \hbox (21.36719pt too wide) in paragraph at lines 31832--31832 [][]\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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 \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 31832--31832 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [520] Overfull \hbox (17.43065pt too wide) in paragraph at lines 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 [] \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 31948--31948 \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 31948--31948 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [521] Overfull \hbox (12.44437pt too wide) in paragraph at lines 31948--31948 [][]\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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 \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 31948--31948 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [522] Overfull \hbox (10.86975pt too wide) in paragraph at lines 32046--32046 \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 32046--32046 \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 32046--32046 \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 32046--32046 [] \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 32046--32046 \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 32046--32046 \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 32046--32046 [][]\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 32046--32046 \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 32046--32046 \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 32046--32046 [][]\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 32046--32046 [][]\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 32046--32046 []\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 32046--32046 \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 32046--32046 []\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 32046--32046 \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 32046--32046 []\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 32046--32046 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [523] [524] Overfull \hbox (42.36206pt too wide) in paragraph at lines 32075--32075 [][]\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 32075--32075 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [525] Overfull \hbox (26.30504pt too wide) in paragraph at lines 32165--32165 []\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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 \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 32165--32165 [] \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 32165--32165 \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 32165--32165 \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 32165--32165 [][]\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 32165--32165 \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 32165--32165 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [526] [527] Overfull \hbox (28.9294pt too wide) in paragraph at lines 32255--32255 []\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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 \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 32255--32255 [] \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 32255--32255 \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 32255--32255 \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 32255--32255 [][]\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 32255--32255 \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 32255--32255 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [528] [529] Overfull \hbox (28.9294pt too wide) in paragraph at lines 32353--32353 []\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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 \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 32353--32353 [] \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 32353--32353 \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 32353--32353 \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 32353--32353 [][]\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 32353--32353 \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 32353--32353 [][]\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 32353--32353 []\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 32353--32353 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] Overfull \hbox (23.68068pt too wide) in paragraph at lines 32451--32451 []\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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 \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 32451--32451 [] \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 32451--32451 \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 32451--32451 \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 32451--32451 [][]\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 32451--32451 \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 32451--32451 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [532] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32451--32451 []\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 32451--32451 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [533] Overfull \hbox (8.09445pt too wide) in paragraph at lines 32554--32554 []\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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 []\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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 []\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 32554--32554 \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 32554--32554 \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 32554--32554 \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 32554--32554 [] \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 32554--32554 \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 32554--32554 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [534] Overfull \hbox (8.24539pt too wide) in paragraph at lines 32554--32554 [][]\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 32554--32554 \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 32554--32554 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [535] Overfull \hbox (2.52588pt too wide) in paragraph at lines 32595--32595 \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 32595--32595 \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 32595--32595 \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 32595--32595 \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 32595--32595 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [536] Overfull \hbox (34.3893pt too wide) in paragraph at lines 32754--32754 []\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 [537] Overfull \hbox (65.9813pt too wide) in paragraph at lines 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 [] \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 32754--32754 \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 32754--32754 \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 32754--32754 [][]\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 32754--32754 \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 32754--32754 \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 32754--32754 \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 32754--32754 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [538] Overfull \hbox (10.86975pt too wide) in paragraph at lines 32844--32844 \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 32844--32844 \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 32844--32844 \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 32844--32844 [] \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 32844--32844 \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 32844--32844 \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 32844--32844 [][]\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 32844--32844 []\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 32844--32844 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [539] Overfull \hbox (18.3807pt too wide) in paragraph at lines 32924--32924 []\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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 []\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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 \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 32924--32924 []\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 32924--32924 [][]\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 32924--32924 \T1/cmtt/m/n/10 table source function using the []astPutChannelData[] function. The source function [540] Overfull \hbox (26.6159pt too wide) in paragraph at lines 32982--32982 \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 32982--32982 \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 32982--32982 [][]\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 32982--32982 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [541] Overfull \hbox (10.60732pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 The HEALPix order of the cell to test. Zero is returned if this is higher than Overfull \hbox (5.09616pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 The " npix" value identifying the cell to test (see the MOC rec ommendation for Overfull \hbox (21.36719pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 Indicates the value to return if the tested cell is not include d at the specified Overfull \hbox (39.2669pt too wide) in paragraph at lines 33033--33033 \T1/cmtt/m/n/10 One if the specified cell is included in the Moc at the specifi ed order, of (if " parent" [542] Overfull \hbox (7.19565pt too wide) in paragraph at lines 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 [][]\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 33113--33113 \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 33113--33113 \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 33113--33113 \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 33113--33113 [][]\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 33113--33113 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [543] Overfull \hbox (10.55888pt too wide) in paragraph at lines 33202--33202 []\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 33202--33202 \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 33202--33202 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (5.3586pt too wide) in paragraph at lines 33202--33202 [] \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 \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 33202--33202 []\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 33202--33202 [][]\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 33202--33202 [][]\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 33202--33202 \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 33202--33202 [][]\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 33202--33202 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [544] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33296--33296 [] \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 [][]\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 33296--33296 \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 33296--33296 [][]\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 33296--33296 \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 33296--33296 []\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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 []\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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 \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 33296--33296 []\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 33296--33296 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [545] Overfull \hbox (28.76947pt too wide) in paragraph at lines 33296--33296 []\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 33296--33296 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [546] Overfull \hbox (6.88478pt too wide) in paragraph at lines 33536--33536 []\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 33536--33536 [] \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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 [][]\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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 [][]\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 33536--33536 []\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 33536--33536 \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 33536--33536 \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 33536--33536 \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 33536--33536 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [547] Overfull \hbox (33.75575pt too wide) in paragraph at lines 33536--33536 \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 33536--33536 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [548] Overfull \hbox (43.93668pt too wide) in paragraph at lines 33536--33536 [][]\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 33536--33536 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [549] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33626--33626 \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 33626--33626 \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 33626--33626 \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 33626--33626 \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 33626--33626 [] \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 33626--33626 \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 33626--33626 \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 33626--33626 [][]\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 33626--33626 \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 33626--33626 \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 33626--33626 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [550] [551] Overfull \hbox (10.60732pt too wide) in paragraph at lines 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 [] \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 33708--33708 \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 33708--33708 \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 33708--33708 [][]\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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 \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 33708--33708 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [552] Overfull \hbox (23.25832pt too wide) in paragraph at lines 33738--33738 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [553] Overfull \hbox (12.97206pt too wide) in paragraph at lines 33806--33806 []\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 33806--33806 \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 33806--33806 \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 33806--33806 \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 33806--33806 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 1 for both its []N in[] and []Nout[] attributes. Overfull \hbox (49.76434pt too wide) in paragraph at lines 33806--33806 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 33806--33806 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [554] Overfull \hbox (10.3477pt too wide) in paragraph at lines 33887--33887 []\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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 \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 33887--33887 [][]\T1/cmtt/m/n/10 The Mapping supplied must have the value 2 for both its []N in[] and []Nout[] attributes. Overfull \hbox (49.76434pt too wide) in paragraph at lines 33887--33887 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 33887--33887 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [555] Overfull \hbox (20.84514pt too wide) in paragraph at lines 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (15.85603pt too wide) in paragraph at lines 34059--34059 [] \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [556] Overfull \hbox (42.09962pt too wide) in paragraph at lines 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 []\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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 \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 34059--34059 [][]\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 34059--34059 \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 34059--34059 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these Overfull \hbox (1.47614pt too wide) in paragraph at lines 34059--34059 []\T1/cmtt/m/n/10 If the output grid is so large that an integer pixel index, ( or a count of pixels) Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 could exceed the largest value that can be represented by a 4-b yte integer, then the Overfull \hbox (7.7746pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 alternative " 8-byte" interface for this function should be use d. This alternative Overfull \hbox (18.27203pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 interface uses 8 byte integer arguments (instead of 4-byte) to hold pixel indices and Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 pixel counts. Specifically, the arguments " lbnd" , " ubnd" , " outdim" are changed Overfull \hbox (13.02332pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 from type " int" to type " int64_t" (defined in header file std int.h). The function Overfull \hbox (7.7746pt too wide) in paragraph at lines 34059--34059 \T1/cmtt/m/n/10 name is changed by appending the digit " 8" to the name. Thus, astTranGrid becomes [557] Overfull \hbox (9.9315pt too wide) in paragraph at lines 34161--34161 []\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 34161--34161 \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 34161--34161 \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 34161--34161 \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 34161--34161 \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 34161--34161 \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 34161--34161 [] \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 34161--34161 \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 34161--34161 \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 34161--34161 [][]\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 34161--34161 \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 34161--34161 [][]\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 34161--34161 \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 34161--34161 \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 34161--34161 \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 34161--34161 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [558] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34161--34161 []\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 34161--34161 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [559] Overfull \hbox (7.72334pt too wide) in paragraph at lines 34281--34281 []\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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (57.84578pt too wide) in paragraph at lines 34281--34281 [] \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [560] Overfull \hbox (10.86975pt too wide) in paragraph at lines 34281--34281 [][]\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 34281--34281 \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 34281--34281 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these Overfull \hbox (49.76434pt too wide) in paragraph at lines 34281--34281 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (13.02332pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 Specifically, the arguments " npoint" , " indim" and " outdim" are changed from type Overfull \hbox (2.52588pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 " int" to type " int64_t" (defined in header file stdint.h). Th e function name is Overfull \hbox (2.52588pt too wide) in paragraph at lines 34281--34281 \T1/cmtt/m/n/10 changed by appending the digit " 8" to the name. Thus, astTranN becomes astTranN8 Underfull \hbox (badness 10000) in paragraph at lines 34281--34281 [561] Overfull \hbox (5.31017pt too wide) in paragraph at lines 34387--34387 []\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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 \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 34387--34387 [][]\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 34387--34387 \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 34387--34387 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these [562] Overfull \hbox (49.76434pt too wide) in paragraph at lines 34387--34387 []\T1/cmtt/m/n/10 If the number of points to be transformed exceeds the largest value that can be represented Overfull \hbox (23.52075pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 by a 4-byte integer, then the alternative " 8-byte" interface f or this function should Overfull \hbox (25.09537pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 be used. This alternative interface uses 8 byte integer argumen ts (instead of 4-byte). Overfull \hbox (18.27203pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 Specifically, the argument " npoint" , is changed from type " i nt" to type " int64_t" Overfull \hbox (28.2446pt too wide) in paragraph at lines 34387--34387 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [563] Overfull \hbox (0.10988pt too wide) in paragraph at lines 34469--34469 \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 34469--34469 \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 34469--34469 [][]\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 34469--34469 \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 34469--34469 Overfull \hbox (2.001pt too wide) in paragraph at lines 34469--34469 \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 34469--34469 []\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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \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 34469--34469 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [564] Overfull \hbox (5.3586pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 [][]\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 34582--34582 \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 34582--34582 Overfull \hbox (7.51216pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 [565] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34582--34582 \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 34582--34582 \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 34582--34582 \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 34582--34582 \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 [566] Overfull \hbox (7.51216pt too wide) in paragraph at lines 34790--34790 []\T1/cmtt/m/n/10 void astUinterp( int ndim_in, const AstDim lbnd_in[], const A stDim ubnd_in[], const Overfull \hbox (9.68182pt too wide) in paragraph at lines 34790--34790 \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 <$\T1/cmtt/m/n/10 Xtype$\OML/zplm/m/it/10 >$ \T1 /cmtt/m/n/10 in_var[], AstDim npoint, const AstDim offset[], const Overfull \hbox (9.893pt too wide) in paragraph at lines 34790--34790 \T1/cmtt/m/n/10 double $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 const coords[], co nst 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 X type$\OML/zplm/m/it/10 >$ Overfull \hbox (42.36206pt too wide) in paragraph at lines 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 [] \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [567] Overfull \hbox (21.36719pt too wide) in paragraph at lines 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 []\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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [568] Overfull \hbox (14.44772pt too wide) in paragraph at lines 34790--34790 [][]\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 34790--34790 [][]\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 34790--34790 [][]\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 34790--34790 \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 34790--34790 \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 34790--34790 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [569] Overfull \hbox (5.3586pt too wide) in paragraph at lines 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 [][]\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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 \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 34881--34881 [][]\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 34881--34881 \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 34881--34881 \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 34881--34881 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [570] [571] Overfull \hbox (0.10988pt too wide) in paragraph at lines 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [572] Overfull \hbox (18.74283pt too wide) in paragraph at lines 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [573] Overfull \hbox (10.86975pt too wide) in paragraph at lines 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 [][]\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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 \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 35179--35179 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [574] Overfull \hbox (7.51216pt too wide) in paragraph at lines 35179--35179 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [575] Overfull \hbox (0.10988pt too wide) in paragraph at lines 35240--35240 \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 35240--35240 \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 35240--35240 \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 35240--35240 \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 35240--35240 [] \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 35240--35240 \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 35240--35240 \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 35240--35240 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [576] Overfull \hbox (26.30504pt too wide) in paragraph at lines 35343--35343 []\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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 \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 35343--35343 [] \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 35343--35343 \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 35343--35343 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [577] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35343--35343 [][]\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 35343--35343 []\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 35343--35343 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [578] Overfull \hbox (47.61078pt too wide) in paragraph at lines 35405--35405 \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 35405--35405 \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 35405--35405 [][]\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 35405--35405 \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 35405--35405 [][]\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 35405--35405 [][]\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 35405--35405 \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 35405--35405 [][]\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 35405--35405 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [579] Overfull \hbox (12.76088pt too wide) in paragraph at lines 35440--35440 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [580] Overfull \hbox (44.25319pt too wide) in paragraph at lines 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 []\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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \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 35542--35542 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [581] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35542--35542 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [582] Overfull \hbox (0.37231pt too wide) in paragraph at lines 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 \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 35595--35595 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [583] Overfull \hbox (21.05632pt too wide) in paragraph at lines 35779--35779 []\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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [584] Overfull \hbox (15.85603pt too wide) in paragraph at lines 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 []\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 35779--35779 \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 35779--35779 \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 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 35779--35779 Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 35779--35779 Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 [] \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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 copied unchanged. []Projection[] parameter 1 associatyed with t he latitude axis Underfull \hbox (badness 10000) in paragraph at lines 35779--35779 \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 35779--35779 \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 35779--35779 \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 35779--35779 [][]\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 35779--35779 \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 35779--35779 \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 35779--35779 [][]\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 35779--35779 \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 35779--35779 [][]\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 35779--35779 \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 35779--35779 \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 35779--35779 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [585] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35779--35779 [][]\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 35779--35779 []\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 35779--35779 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [586] Overfull \hbox (23.4695pt too wide) in paragraph at lines 35885--35885 []\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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 \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 35885--35885 [] \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 35885--35885 \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 35885--35885 \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 35885--35885 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [587] Overfull \hbox (2.26344pt too wide) in paragraph at lines 35885--35885 []\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 35885--35885 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [588] Overfull \hbox (7.51216pt too wide) in paragraph at lines 35948--35948 \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 35948--35948 \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 35948--35948 \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 35948--35948 [][]\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 35948--35948 [][]\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 35948--35948 \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 35948--35948 \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 35948--35948 \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 35948--35948 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [589] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35985--35985 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [590] Overfull \hbox (8.56807pt too wide) in paragraph at lines 36086--36086 []\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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 []\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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 []\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 36086--36086 \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 36086--36086 \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 36086--36086 \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 36086--36086 [] \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 36086--36086 \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 36086--36086 \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 36086--36086 [][]\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 36086--36086 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [591] Overfull \hbox (5.62103pt too wide) in paragraph at lines 36086--36086 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [592] Overfull \hbox (8.09445pt too wide) in paragraph at lines 36189--36189 []\T1/cmtt/m/n/10 AstYamlChan $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astYamlChan ( 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 36189--36189 \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 this function will be used by the YamlChan to obtain lines of i nput text. On Overfull \hbox (21.36719pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 []\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 36189--36189 \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 this function will be used by the YamlChan to deliver lines of output text. On Overfull \hbox (5.62103pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 []\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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 of attribute assignments to be used for initialising the new Ya mlChan. The syntax Overfull \hbox (26.6159pt too wide) in paragraph at lines 36189--36189 \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 36189--36189 [] \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 36189--36189 \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 36189--36189 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [593] Overfull \hbox (8.24539pt too wide) in paragraph at lines 36189--36189 [][]\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 36189--36189 \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 36189--36189 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [594] Overfull \hbox (26.09103pt too wide) in paragraph at lines 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 \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 36270--36270 [] \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 36270--36270 \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 36270--36270 \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 36270--36270 [][]\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 36270--36270 []\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 36270--36270 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [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] Overfull \hbox (37.49187pt too wide) in paragraph at lines 37254--37254 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [620] [621] [622] [623] [624] [625] [626] [627] [628] [629] [630] [631] [632] [633] [634] [635] [636] [637] [638] [639] [640] [641] [642] [643] [644] [645] [646] [647] [648] [649] [650] [651] [652] [653] [654] [655] [656] [657] [658] [659] [660] [661] [662] [663] [664] [665] [666] [667] [668] [669] [670] [671] [672] [673] [674] [675] [676] [677] [678] [679] [680] [681] [682] [683] [684] [685] [686] [687] [688] [689] [690] [691] [692] [693] [694] [695] [696] [697] [698] [699] [700] [701] [702] [703] [704] [705] [706] [707] [708] [709] [710] [711] [712] [713] [714] [715] [716] [717] [718] [719] [720] [721] [722] [723] [724] [725] [726] [727] [728] [729] [730] [731] [732] [733] [734] [735] [736] [737] [738] [739] [740] [741] [742] [743] [744] [745] [746] [747] [748] [749] [750] [751] Overfull \hbox (59.49594pt too wide) in paragraph at lines 42947--42947 \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)=- [752] [753] [754] [755] [756] Underfull \hbox (badness 10000) in paragraph at lines 43131--43131 [757] [758] [759] [760] [761] [762] [763] [764] [765] [766] [767] [768] [769] [770] [771] [772] [773] Overfull \hbox (238.94087pt too wide) in paragraph at lines 43837--43837 \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 [774] Overfull \hbox (190.3857pt too wide) in paragraph at lines 43868--43868 \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 [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] Overfull \hbox (146.29462pt too wide) in paragraph at lines 45732--45732 \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. [808] [809] [810] [811] [812] [813] [814] [815] [816] [817] [818] [819] [820] [821] Underfull \hbox (badness 10000) in paragraph at lines 46365--46365 [822] [823] [824] [825] [826] [827] [828] [829] [830] [831] [832] [833] [834] [835] [836] [837] [838] [839] [840] [841] [842] [843] [844] [845] [846] [847] [848] [849] [850] [851] [852] [853] [854] [855] [856] [857] [858] [859] [860] [861] [862] [863] [864] [865] [866] [867] [868] [869] [870] [871] [872] [873] [874] [875] [876] [877] [878] [879] [880] [881] [882] [883] [884] [885] [886] [887] [888] [889] [890] [891] [892] [893] [894] [895] [896] [897] [898] [899] Overfull \hbox (7.12534pt too wide) in paragraph at lines 50910--50910 \T1/ppl/m/n/10 (-20) CAL_GROUP_CENTER, UN-KNOWN-Ref-Pos, EM-BARYCEN-TER, MOON, MER-CURY, VENUS, [900] [901] [902] [903] [904] [905] [906] [907] [908] [909] [910] [911] [912] [913] [914] [915] [916] [917] Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 Underfull \hbox (badness 10000) in paragraph at lines 51868--51868 [918] [919] [920] Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 Underfull \hbox (badness 10000) in paragraph at lines 52033--52033 [921] [922] [923] Overfull \hbox (5.62103pt too wide) in paragraph at lines 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 [] \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 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 []\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 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 \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 52155--52155 [][]\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 52155--52155 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [924] Overfull \hbox (5.62103pt too wide) in paragraph at lines 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 [] \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 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 []\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 52231--52231 \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 52231--52231 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (15.85603pt too wide) in paragraph at lines 52231--52231 [] \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 52231--52231 \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 52231--52231 Overfull \hbox (28.50703pt too wide) in paragraph at lines 52231--52231 \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 52231--52231 \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 52231--52231 \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 52231--52231 [][]\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 52231--52231 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [925] Overfull \hbox (21.10757pt too wide) in paragraph at lines 52352--52352 []\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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.10475pt too wide) in paragraph at lines 52352--52352 [] \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [926] Overfull \hbox (7.51216pt too wide) in paragraph at lines 52352--52352 \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 52352--52352 \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 52352--52352 \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 52352--52352 [][]\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 52352--52352 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [927] Overfull \hbox (2.26344pt too wide) in paragraph at lines 52400--52400 \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 52400--52400 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [928] Overfull \hbox (21.10475pt too wide) in paragraph at lines 52436--52436 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [929] Overfull \hbox (42.36206pt too wide) in paragraph at lines 52480--52480 [] \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \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 52480--52480 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [930] [931] Overfull \hbox (10.13652pt too wide) in paragraph at lines 52531--52531 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [932] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52572--52572 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [933] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52618--52618 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [934] [935] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52683--52683 \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 52683--52683 \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 52683--52683 \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 52683--52683 [][]\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 52683--52683 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [936] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52737--52737 \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 52737--52737 \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 52737--52737 [][]\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 52737--52737 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [937] Overfull \hbox (35.49646pt too wide) in paragraph at lines 52811--52811 []\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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 [][]\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 52811--52811 \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 52811--52811 \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 52811--52811 \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 52811--52811 [][]\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 52811--52811 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [938] Overfull \hbox (13.86804pt too wide) in paragraph at lines 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 \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 52946--52946 [][]\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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [939] Overfull \hbox (13.02332pt too wide) in paragraph at lines 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 []\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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 []\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 52946--52946 \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 52946--52946 \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 52946--52946 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [940] [941] Overfull \hbox (1.84724pt too wide) in paragraph at lines 53022--53022 []\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 53022--53022 \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 53022--53022 \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 53022--53022 \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 53022--53022 [] \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 53022--53022 [] \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 53022--53022 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [942] Overfull \hbox (10.86975pt too wide) in paragraph at lines 53053--53053 [] \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 53053--53053 \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 53053--53053 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [943] Overfull \hbox (10.86975pt too wide) in paragraph at lines 53091--53091 [] \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 53091--53091 \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 53091--53091 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [944] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53154--53154 [] \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 53154--53154 \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 53154--53154 [][]\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 53154--53154 \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 53154--53154 \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 53154--53154 [][]\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 53154--53154 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [945] Overfull \hbox (7.7746pt too wide) in paragraph at lines 53195--53195 \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 53195--53195 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [946] Overfull \hbox (2.26344pt too wide) in paragraph at lines 53236--53236 \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 53236--53236 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [947] Overfull \hbox (12.18193pt too wide) in paragraph at lines 53272--53272 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see []ast Tune[] in objectc.c). [948] Overfull \hbox (42.36206pt too wide) in paragraph at lines 53329--53329 [] \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 53329--53329 \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 53329--53329 \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 53329--53329 \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 53329--53329 [][]\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 53329--53329 \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 53329--53329 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [949] [950] Overfull \hbox (0.37231pt too wide) in paragraph at lines 53386--53386 [] \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 53386--53386 \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 53386--53386 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [951] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53450--53450 [] \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 \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 53450--53450 [][]\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 53450--53450 \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 53450--53450 \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 53450--53450 [][]\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 53450--53450 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [952] Overfull \hbox (4.1005pt too wide) in paragraph at lines 53502--53502 \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 53502--53502 \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 53502--53502 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [953] Overfull \hbox (21.10475pt too wide) in paragraph at lines 53574--53574 \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 53574--53574 \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 53574--53574 \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 53574--53574 \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 53574--53574 []\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 53574--53574 \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 53574--53574 [][]\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 53574--53574 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [954] Overfull \hbox (5.62103pt too wide) in paragraph at lines 53619--53619 \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 53619--53619 \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 53619--53619 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [955] Underfull \hbox (badness 1490) in paragraph at lines 53688--53688 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, Overfull \hbox (7.69725pt too wide) in paragraph at lines 53663--53720 [][] [956] [957] [958] Underfull \hbox (badness 2103) in paragraph at lines 53857--53857 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the Underfull \hbox (badness 4291) in paragraph at lines 53865--53866 []|\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 53826--53877 [][] [959] [960] [961] Underfull \hbox (badness 4713) in paragraph at lines 54033--54033 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the Underfull \hbox (badness 3229) in paragraph at lines 54042--54043 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the Underfull \hbox (badness 2261) in paragraph at lines 54054--54054 []|\T1/ppl/m/n/9 (+20) Used to set the []Epoch[] at-tributes of the Underfull \hbox (badness 1931) in paragraph at lines 54059--54060 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the Underfull \hbox (badness 3657) in paragraph at lines 54068--54069 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 54077--54077 []|\T1/ppl/m/n/9 (+20) Used to set the []Rest-Freq[] at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 54077--54078 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 54083--54083 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 54083--54084 []|\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 54019--54092 [][] [962] [963] [964] [965] [966] [967] [968] [969] [970] [971] [972] [973] [974] [975] [976] [977] [978] [979] [980] [981] [982] [983] [984] Overfull \hbox (36.88722pt too wide) in paragraph at lines 55553--55556 \T1/ppl/m/n/10.95 (-20) class. These are flux-conserving al-ter-na-tives to the ex-ist-ing AST_RESAMPLE/astResample [985] [986] [987] [988] [989] [990] [991] [992] [993] [994] [995] [996] [997] [998] [999] [1000] [1001] [1002] [1003] [1004] [1005] [1006] [1007] [1008] [1009] [1010] [1011] (./sun211.aux) LaTeX Warning: There were multiply-defined labels. ) (\end occurred inside a group at level 1) ### simple group (level 1) entered at line 6736 ({) ### bottom level (see the transcript file for additional information) < /usr/share/texlive/texmf-dist/fonts/type1/urw/palatino/uplb8a.pfb> Output written on sun211.pdf (1034 pages, 2818054 bytes). Transcript written on sun211.log. latex2html -noaddress sun211.tex This is LaTeX2HTML Version 2024.2 (Released October 21, 2024) ...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/reproducible-path/starlink-ast-9.2.10+dfsg/sun211.tex Note: Working directory is /build/reproducible-path/starlink-ast-9.2.10+dfsg/sun211 Note: Images will be generated in /tmp/l2h11436 texexpand V2024.2 (Released October 21, 2024) 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/reproducible-path/starlink-ast-9.2.10+dfsg/sun211.aux ... Processing macros ...,,,,++...........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,,................................................................................................................................................................,,.................................................................................................................................................,,....................,,...............................................................................................................................................................................,,.............................................,,.....,,..........,,.........................,,.....,,.....,,.............................................,,...........................................................................,,...........................................................................................................................................................,,.....,,.............................................,,..............................,,..........,,........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... Translating ... 0/326:top of sun211: for sun211.html *** translating preamble *** ............................ Warning: No implementation found for document class: starlink............. *** preamble done *** ;.,....;.. 1/326:section:.."Introduction" for node1.html ;..;...... 2/326:subsection:.."What Problems Does AST Tackle?" for node2.html ;..,...........;................... 3/326:subsection:.."Other Design Objectives" for node3.html ;..,........,.......,.,..........;....... 4/326:subsection:.."What Does ``AST'' Stand For?" for node4.html ;..;... 5/326:section:.."Overview of AST Concepts" for node5.html ;..; 6/326:subsection:..."Relationships Between Coordinate Systems" for node6.html ;..,,........;........... 7/326:subsection:..."Mappings Available" for node7.html ;..,............;....................................... 8/326:subsection:..."Compound Mappings" for node8.html ;..,,.....,,........,,......;.................. 9/326:subsection:.."Representing Coordinate Systems" for node9.html ;.,,..........,,.......;........................... 10/326:subsection:.."Networks of Coordinate Systems" for node10.html ;.,,.........;................ 11/326:subsection:.."Input/Output Facilities" for node11.html ;..............;....................... 12/326:subsection:.."Producing Graphical Output" for node12.html ;.....,,........;.................... 13/326:section:...."How To..." for node13.html ;...;... 14/326:subsection:..."...Obtain and Install AST" for node14.html ;.....; 15/326:subsection:..."...Structure an AST Program" for node15.html ;..,..;........ 16/326:subsection:...."...Build an AST Program" for node16.html ;..,..,....;......... 17/326:subsection:...."...Read a WCS Calibration from a Dataset" for node17.html ;..,....;............................ 18/326:subsection:..."...Validate WCS Information" for node18.html ;..,..;............ 19/326:subsection:..."...Display AST Data" for node19.html ;..,...;............ 20/326:subsection:...."...Convert Between Pixel and World Coordinates" for node20.html ;..,.....;................... 21/326:subsection:...."...Test if a WCS is a Celestial Coordinate System" for node21.html ;...,..;.... 22/326:subsection:...."...Test if a WCS is a Spectral Coordinate System" for node22.html ;.; 23/326:subsection:...."...Format Coordinates for Display" for node23.html ;..,...,.;......................... 24/326:subsection:..."...Display Coordinates as they are Transformed" for node24.html ;..,....;................ 25/326:subsection:..."...Read Coordinates Entered by a User" for node25.html ;...,...;.................. 26/326:subsection:...."...Create a New WCS Calibration" for node26.html ;...,.,...,.,.,.......;......................... 27/326:subsection:...."...Modify a WCS Calibration" for node27.html ;....,.,..,...,...;.......................... 28/326:subsection:...."...Write a Modified WCS Calibration to a Dataset" for node28.html ;...,..................;............................................................ 29/326:subsection:...."...Display a Graphical Coordinate Grid" for node29.html ;.,,.................;.................... 30/326:subsection:...."...Switch to Plot a Different Celestial Coordinate Grid" for node30.html ;...........;............. 31/326:subsection:..."...Give a User Control Over the Appearance of a Plot" for node31.html ;.............;................... 32/326:section:..."An AST Object Primer" for node32.html ;.,...;. 33/326:subsection:.."AST Objects" for node33.html ;....;..... 34/326:subsection:..."Object Creation and Pointers" for node34.html ;.....,...;................ 35/326:subsection:..."The Object Hierarchy" for node35.html ;................;...................... 36/326:subsection:..."Displaying Objects" for node36.html ;..,..........;.................. 37/326:subsection:..."Getting Attribute Values" for node37.html ;.............;.......... 38/326:subsection:..."Setting Attribute Values" for node38.html ;.......................,,,................;.................. 39/326:subsection:..."Testing, Clearing and Defaulting Attributes" for node39.html ;.............;.......... 40/326:subsection:..."Transforming Coordinates" for node40.html ;...............................;............ 41/326:subsection:..."Managing Object Pointers" for node41.html ;........;......... 42/326:subsection:..."AST Pointer Contexts---Begin and End" for node42.html ;............;............... 43/326:subsection:.."Exporting, Importing and Exempting AST Pointers" for node43.html ;...........;........... 44/326:subsection:.."AST Objects within Multi-threaded Applications" for node44.html ;....;............. 45/326:subsubsection:.."Locking AST Objects for Exclusive Use" for node45.html ;.......;...... 46/326:subsubsection:.."AST Pointer Contexts" for node46.html ;...;..... 47/326:subsection:..."Copying Objects" for node47.html ;........;.... 48/326:subsection:.."C Pointer Types" for node48.html ;........,,..,.....,..........;.................... 49/326:subsection:..."Error Detection" for node49.html ;..............................;................. 50/326:subsection:.."Sharing the Error Status" for node50.html ;........;..... 51/326:section:..."Inter-Relating Coordinate Systems (Mappings)" for node51.html ;...;.......... 52/326:subsection:..."The Mapping Class" for node52.html ;.....;......... 53/326:subsection:.."The Mapping Model" for node53.html ;..;....... 54/326:subsection:.."Changing Attributes of a Mapping" for node54.html ;...;....... 55/326:subsection:.."Input and Output Coordinate Numbers" for node55.html ;.......;........ 56/326:subsection:.."Forward and Inverse Transformations" for node56.html ;......;....... 57/326:subsection:..."Inverting Mappings" for node57.html ;........;.......... 58/326:subsection:.."Finding the Rate of Change of a Mapping Output" for node58.html ;.;.. 59/326:subsection:.."Reporting Coordinate Transformations" for node59.html ;...;................. 60/326:subsection:..."Handling Missing (Bad) Coordinate Values" for node60.html ;.......,,..;............... 61/326:subsection:..."Example---the UnitMap" for node61.html ;........;...... 62/326:subsection:..."Example---the PermMap" for node62.html ;..,,................,,,,........,,,...;............... 63/326:section:..."Compound Mappings (CmpMaps)" for node63.html ;..;... 64/326:subsection:..."Combining Mappings in Series" for node64.html ;.,,.,........;................. 65/326:subsection:.."Combining Mappings in Parallel" for node65.html ;..,,........;................... 66/326:subsection:..."The Component Mappings" for node66.html ;....;.............. 67/326:subsection:..."Creating More Complex Mappings" for node67.html ;........;....... 68/326:subsection:..."Example---Transforming Between Two Calibrated Images" for node68.html ;........;......... 69/326:subsection:..."Over-Complex Compound Mappings" for node69.html ;.......;................ 70/326:subsection:..."Simplifying Compound Mappings" for node70.html ;..,,...........,.....;........... 71/326:section:..."Representing Coordinate Systems (Frames)" for node71.html ;...;................... 72/326:subsection:.."The Frame Model" for node72.html ;.,,...;..... 73/326:subsection:..."Creating a Frame" for node73.html ;......;.. 74/326:subsection:..."Using a Frame as a Mapping" for node74.html ;..........;.................... 75/326:subsection:..."Frame Axis Attributes" for node75.html ;...................;.............. 76/326:subsection:..."Frame Attributes" for node76.html ;..,,...........................................................................;.... 77/326:subsection:..."Formatting Axis Values" for node77.html ;........,....;................ 78/326:subsection:..."Normalising Frame Coordinates" for node78.html ;........;.......... 79/326:subsection:..."Reading Formatted Axis Values" for node79.html ;...........,..........................;............... 80/326:subsection:..."Permuting Frame Axes" for node80.html ;.....,,.....;.... 81/326:subsection:.."Selecting Frame Axes" for node81.html ;............;................. 82/326:subsection:..."Calculating Distances, Angles and Offsets" for node82.html ;......,...........,....;............... 83/326:subsection:..."The Domain Attribute" for node83.html ;...,.,....,....,...........;..................... 84/326:subsection:..."Conventions for Domain Names" for node84.html ;.,,,,..,,.....................................;....... 85/326:subsection:..."The Unit Attribute" for node85.html ;...............,,..;................. 86/326:subsubsection:..."The Syntax for Unit Strings" for node86.html ;.....,,,.........,,,,.........,,,....,,,,,,,,,,,,,,,,,,,,............................,,,....,,......;........ 87/326:subsubsection:.."Side-effects of Changing the Unit attribute" for node87.html ;.;... 88/326:section:..."Celestial Coordinate Systems (SkyFrames)" for node88.html ;..;..... 89/326:subsection:.."The SkyFrame Model" for node89.html ;.......;.................... 90/326:subsection:.."Creating a SkyFrame" for node90.html ;......;. 91/326:subsection:.."Specifying a Particular Celestial Coordinate System" for node91.html ;......,..,.;............ 92/326:subsection:.."Attributes which Qualify Celestial Coordinate Systems" for node92.html ;....,,......................;............. 93/326:subsection:.."Using Default SkyFrame Attributes" for node93.html ;...........;......... 94/326:subsection:..."Formatting Celestial Coordinates" for node94.html ;....,,..,,,....................................................,.........;.................... 95/326:subsection:..."Reading Formatted Celestial Coordinates" for node95.html ;...,,.,..,..,,...,..,,.....,,.,,,,,......,,,,,......,,...;............................ 96/326:subsection:.."Representing Offsets from a Specified Sky Position" for node96.html ;...;.... 97/326:section:...."ss_specframesSpectral Coordinate Systems (SpecFrames)" for node97.html ;..;..... 98/326:subsection:.."The SpecFrame Model" for node98.html ;...;................ 99/326:subsection:.."Creating a SpecFrame" for node99.html ;......;. 100/326:subsection:.."Specifying a Particular Spectral Coordinate System" for node100.html ;.....,..;..... 101/326:subsection:.."Attributes which Qualify Spectral Coordinate Systems" for node101.html ;....,,............................;.......... 102/326:subsection:.."Using Default SpecFrame Attributes" for node102.html ;........,..........;........... 103/326:subsection:..."Creating Spectral Cubes" for node103.html ;.......,,,,,,,.;.......... 104/326:subsection:..."Handling Dual-Sideband Spectra" for node104.html ;.,,,..,..,,.....,,....,,,..,,...;........... 105/326:subsubsection:.."Aligning Dual-Sideband Spectra" for node105.html ;..............,,.......,,........,.;....................... 106/326:section:...."ss_timeframesTime Systems (TimeFrames)" for node106.html ;..;..... 107/326:subsection:.."The TimeFrame Model" for node107.html ;...;................... 108/326:subsection:.."Creating a TimeFrame" for node108.html ;......;. 109/326:subsection:.."Specifying a Particular Time System" for node109.html ;.....,..;...... 110/326:subsection:.."Attributes which Qualify Time Coordinate Systems" for node110.html ;....,,...............;........... 111/326:section:..."Compound Frames (CmpFrames)" for node111.html ;...;.... 112/326:subsection:.."Creating a CmpFrame" for node112.html ;........;.... 113/326:subsection:.."The Attributes of a CmpFrame" for node113.html ;........;................ 114/326:section:..."An Introduction to Coordinate System Conversions" for node114.html ;..;.................. 115/326:subsection:..."Converting between Celestial Coordinate Systems" for node115.html ;..,....................................;............................ 116/326:subsection:..."Converting between Spectral Coordinate Systems" for node116.html ;,,................;................. 117/326:subsection:.."Converting between Time Coordinate Systems" for node117.html ;.; 118/326:subsection:..."Handling SkyFrame Axis Permutations" for node118.html ;......,..,......;............... 119/326:subsection:..."Converting Between Frames" for node119.html ;.........;................. 120/326:subsection:..."The Choice of Alignment System" for node120.html ;..,,,.....;............. 121/326:section:..."Coordinate System Networks (FrameSets)" for node121.html ;.... Cannot find matching bracket for 26251.;............. 122/326:subsection:.."The FrameSet Model" for node122.html ;...,....;..... 123/326:subsection:..."Creating a FrameSet" for node123.html ;..........;...... 124/326:subsection:..."Adding New Frames to a FrameSet" for node124.html ;.................,,.........;....................... 125/326:subsection:..."The Base and Current Frames" for node125.html ;...........;............ 126/326:subsection:..."Referring to the Base and Current Frames" for node126.html ;.......;.............. 127/326:subsection:..."Using a FrameSet as a Mapping" for node127.html ;..........;...................... 128/326:subsection:..."Extracting a Mapping from a FrameSet" for node128.html ;........;....................... 129/326:subsection:..."Using a FrameSet as a Frame" for node129.html ;......,,.........................;............... 130/326:subsection:.."Extracting a Frame from a FrameSet" for node130.html ;......;......... 131/326:subsection:.."Removing a Frame from a FrameSet" for node131.html ;........;............. 132/326:section:..."Higher Level Operations on FrameSets" for node132.html ;.; 133/326:subsection:..."Creating FrameSets with astConvert" for node133.html ;......,,............;.................... 134/326:subsection:..."Converting between FrameSet Coordinate Systems" for node134.html ;.,,..............,...............;.................................. 135/326:subsection:..."Example---Registering Two Images" for node135.html ;...........,..........;......................... 136/326:subsection:..."Re-Defining a FrameSet Coordinate System" for node136.html ;.....,.......,,.......;........... 137/326:subsection:..."Example---Binning an Image" for node137.html ;.,...........;...... 138/326:subsection:..."Maintaining the Integrity of FrameSets" for node138.html ;..........................;................ 139/326:subsection:.."Merging FrameSets" for node139.html ;.,,..............;.......... 140/326:section:..."Saving and Restoring Objects (Channels)" for node140.html ;....;.......... 141/326:subsection:.."The Channel Model" for node141.html ;...;....... 142/326:subsection:..."Creating a Channel" for node142.html ;.......;.......... 143/326:subsection:..."Writing Objects to a Channel" for node143.html ;.......;...... 144/326:subsection:..."Reading Objects from a Channel" for node144.html ;..............;....... 145/326:subsection:.."Saving and Restoring Multiple Objects" for node145.html ;...;...... 146/326:subsection:..."Validating Input" for node146.html ;.,,,,.........;......... 147/326:subsection:.."Storing an ID String with an Object" for node147.html ;...........;........ 148/326:subsection:..."The Textual Output Format" for node148.html ;...............,.,.....;.............. 149/326:subsection:..."Controlling the Amount of Output" for node149.html ;..,........,....;........... 150/326:subsection:..."Controlling Commenting" for node150.html ;.........;... 151/326:subsection:.."Editing Textual Output" for node151.html ;...,....;....... 152/326:subsection:..."Mixing Objects with other Text" for node152.html ;.......;........ 153/326:subsection:..."Reading Objects from Files" for node153.html ;...................;......... 154/326:subsection:..."Writing Objects to Files" for node154.html ;..................;........... 155/326:subsection:..."Reading and Writing Objects to other Places" for node155.html ;...;......... 156/326:section:..."Storing AST Objects in FITS Headers (FitsChans)" for node156.html ;....;............ 157/326:subsection:..."The Native FITS Encoding" for node157.html ;....;........... 158/326:subsection:.."The FitsChan Model" for node158.html ;...,......,......;.............................................. 159/326:subsection:..."Creating a FitsChan" for node159.html ;......;...... 160/326:subsection:..."Addressing Cards in a FitsChan" for node160.html ;................,.;............ 161/326:subsection:..."Writing Native Objects to a FitsChan" for node161.html ;............;........................... 162/326:subsection:..."Extracting Individual Cards from a FitsChan" for node162.html ;.......;.............. 163/326:subsection:.."The Native FitsChan Output Format" for node163.html ;.......,,,.,.,....;...................... 164/326:subsection:..."Adding Individual Cards to a FitsChan" for node164.html ;............;... 165/326:subsection:..."Adding Concatenated Cards to a FitsChan" for node165.html ;......;........ 166/326:subsection:..."Reading Native Objects From a FitsChan" for node166.html ;........;.................... 167/326:subsection:.."Saving and Restoring Multiple Objects in a FitsChan" for node167.html ;....;...... 168/326:subsection:.."Mixing Native Objects with Other FITS Cards" for node168.html ;....;....... 169/326:subsection:..."Finding and Changing Cards in a FitsChan" for node169.html ;..................;........ 170/326:subsection:..."Source and Sink Functions for FitsChans" for node170.html ;....;............................ 171/326:section:..."Using Foreign FITS Encodings" for node171.html ;...;...... 172/326:subsection:..."The Foreign FITS Encodings" for node172.html ;...,,....................................;......... 173/326:subsection:..."Limitations of Foreign Encodings" for node173.html ;..,.......;................. 174/326:subsection:..."Identifying Foreign Encodings on Input" for node174.html ;....................;.......... 175/326:subsection:..."Reading Foreign WCS Information from a FITS Header" for node175.html ;.............,.......;...................................................................... 176/326:subsection:..."Removing WCS Information from FITS Headers---the Destructive Read" for node176.html ;.............;............... 177/326:subsection:..."Propagating WCS Information through Data Processing Steps" for node177.html ;....,.......;..................... 178/326:subsection:..."Writing Foreign WCS Information to a FITS Header" for node178.html ;...............,......;............... 179/326:section:..."Storing AST Objects as XML (XmlChan)" for node179.html ;...........,...........;............ 180/326:subsection:.."Reading IVOA Space-Time-Coordinates XML (STC-X) Descriptions" for node180.html ;.....;............. 181/326:section:..."Reading and writing STC-S descriptions (StcsChans)" for node181.html ;...;..... 182/326:section:..."Creating Your Own Private Mappings (IntraMaps)" for node182.html ;.; 183/326:subsection:.."The Need for Extensibility" for node183.html ;....;.. 184/326:subsection:.."The IntraMap Model" for node184.html ;...;.................. 185/326:subsection:..."Limitations of IntraMaps" for node185.html ;......;... 186/326:subsection:..."Writing a Transformation Function" for node186.html ;..........;........................... 187/326:subsection:..."Registering a Transformation Function" for node187.html ;..........,..;................. 188/326:subsection:.."Creating an IntraMap" for node188.html ;.........;............... 189/326:subsection:..."Restricted Implementations of Transformation Functions" for node189.html ;..........;...... 190/326:subsection:..."Variable Numbers of Coordinates" for node190.html ;..............;......... 191/326:subsection:..."Adapting a Transformation Function to Individual IntraMaps" for node191.html ;........;....... 192/326:subsection:...."MaxTranSimplifying IntraMaps" for node192.html ;...................;.................... 193/326:subsection:..."Writing and Reading IntraMaps" for node193.html ;.....;.............. 194/326:subsection:..."Managing Transformation Functions in Libraries" for node194.html ;.......;......... 195/326:section:..."Producing Graphical Output (Plots)" for node195.html ;..;... 196/326:subsection:.."The Plot Model" for node196.html ;.........;....... 197/326:subsection:.."Plotting Symbols" for node197.html ;.......;.. 198/326:subsection:..."Plotting Geodesic Curves" for node198.html ;............;......... 199/326:subsection:.."Plotting Curves Parallel to Axes" for node199.html ;.......;....... 200/326:subsection:..."Plotting Generalized Curves" for node200.html ;...;...... 201/326:subsection:..."Clipping" for node201.html ;..........;....... 202/326:subsection:.."Using a Plot as a Mapping" for node202.html ;.....;................ 203/326:subsection:.."Using a Plot as a Frame" for node203.html ;...;................. 204/326:subsection:..."Regions of Valid Physical Coordinates" for node204.html ;....;............ 205/326:subsection:.."Plotting Borders" for node205.html ;.......;..... 206/326:subsection:.."Plotting Text" for node206.html ;........;..... 207/326:subsection:..."Plotting a Grid" for node207.html ;......;........ 208/326:subsection:..."Controlling the Appearance of Sub-strings" for node208.html ;.,....;............ 209/326:subsection:..."Producing Logarithmic Axes" for node209.html ;.,.....;.... 210/326:subsection:..."Choosing a Graphics Package" for node210.html ;.,........;.............. 211/326:section:.."Compiling and Linking Software that Uses AST" for node211.html ;...;.. 212/326:subsection:..."Accessing the ``ast.h'' Header File" for node212.html ;...........;. 213/326:subsection:..."Linking with AST Facilities" for node213.html ;.........,.,.....;........ 214/326:subsection:.."Building ADAM Applications that Use AST" for node214.html ;......,.......;................... 215/326:section:..."The AST Class Hierarchy" for node215.html ;....;... 216/326:section:..."AST Function Descriptions" for node216.html ;........................,,............................................................................,,...........................................,..........................,,,,..........................................................,,,.....................................................................,,...............,..........................,,,.......................................,,...........,,..,...,,,,................................,,,,,,,,,,.........................................................................................,,,,,,............................,,,,.....................,.......................,,.....................................,,,.......................,.....,,,........................,,..................,......,....................,.......................,,......,,,......,,...............,.......................,.................................,..................,...................,,,,..........................................,......................,,,,,,.............................................,............,,,.............................,,,....,,........................................,,..........,,,...........................,,,..............................................................................,,,,................................................,,,,...............,,.........................,....................................................................,,.......................,,,,.......................,..................,,,,.....................................................,,,,.............................................,,....................,,,,..................................,,,,.........................,,.....................,,,,.................................................................................................................................................,,..,,,,.................,,,,,,,............................................,..........,......,,.......,,,,,,............................,,,,..........................,,......................,,,,,,.................,................................,........................................,,...............................,,,,,,,,..............................,.....................,,.................,.......................,,..................,..............,,,,.......................................................,,,,..,......................,............................................................,..........,.................,,.............................................................................................................................................................,,,,.........................................................................................................................................................................,,,,,,...................................,,,,,,.....................................,.................,,,......................,.................,,,..................................................,,.......................,,.....................,,,,.................................................,,,.....................................,,.............,,................,,,,,....,,,,,,...,,,,..,..................................,................,,,.............,,,,..........................................,,,,..................,,.,.,.,.,.,.,,.................................,,,,,,,,,...,,,,.............................,,...............................,,..........,,..............................................,,..............,,.......,,,,.....................,,,,..................,,,....................,,.....................,,..................,,................,,,,......................................,,,,......................,......,.....,.....................................,,................,.............,,................,,..............................,,.................,,.............................,.............,...........,,........................................,,..................................,........,.............................................................................,........,......,,,................,,,..................,,,..........,,,..,.,.........,,,....................................................,,,,,.............................................,............................,.........................................,,.............................,,................,,............,,............,...........,....................................,,,,.......................................,................,,,....................................,,,,,,,,.................................................................,......,,,,..,,,,,...,,,,......,,,,................,,,,,,,,.......,,....................,............,,,,..,,.,,,,.,,,,.,,,,..........................................................,...................................,,...............................,..............,,,.............................,....,........................................,,................,,,.....................,,..........,,,,,,,,....,,,,,,,...........,,.............,,,,,,......,...............................,,,,,,,,..........,,,,,,,,,,,,...........,,.......,..........,,,,,,......,.................,..........................,,,,..................,,,,,,,,..........,,,,,,,,,,......,,.............,,,,,,......,.........................................,,....................,,...................,,................,,.............,,,,,,....,,,,,,,.............,,,,,,......,..................,.................,,,,,,....,,,,,,,..........,,,,,,......,..................,.................,,,,,,,,....,,,,,,..............,,...,,,,,,......,..........................................,,,..............,,,,...........................,,.........,,,..........,............,,,,,.............................,,...........................................,,.........................................,,.,,,,.........,,,,,,,,........................,..............................,,.......,,,,,,............................,,,,.........................,,,.........................,,,,...................................................,,,............,.,...........................................,,,.,,,,..,.,..............................................................,,.,,...........,..,..,,.,.................................,,..,,.,,........................................................................,,...,.,.,.,.............................................,,,,.....,,.,,..,.,...................................,,..................................,,.................,.....................................................................................................................................................................................,,,,,,.,,.,,.,,,,,.,,,,.,,.,,.,,,,.,,.,,.,,,,.,,.,,.,,....................................,.,,.,.,.,,,,.,,,,...,.,..,,.,,.............................,,,..........................,,.................................................,...............,....................................,,......................,........................,,,,,,...........................................,.......,...,........................,,,......................,............,,,................,........................,,............................,,,,..................................................,...........................,.........................,,...,,,,.....................,,,,,,,............................................,...........................................,.........,,............,,,,,,............................,,,,.........................,,...........................,,...................,,,,...........,,.......................,............,...................,,..............................................................................,,,,..............................................................,,,............................................................,,,..............................................................,....,,.....................,,,,,..................................................,..............,,,.,,,,..............,,..........................,,.......................................,,......,,,...........................,,,..................................................................................,,,,...........,,..........................................................,,,,,.................................................,...........,.....,,,,.................................,.......,...........,,.............,,............,,,..................,...................,,,.................,,..................................................,,...................,,,,,,,,,,,,,..............................,,,..........,.,,,,,,,,,,,,,,,,,,,,,,,,,,......................................................,,...............................,,,......................................,,...........................,............,,.,,,,.,,,,...............,,,,,,,,,,,,,...............................,.......................................................................................................................................,,,,,,...........,,,,,,.........,,,,..,,.............................,,,,.,,..................................................,,,,.....................................,,,,,,...,,,,...................,,,,,,,,,,,,,,...........................................,.................................,,.......,,.......................................................................................................................................,,,,,,...........,,,,................,,.............................................................................................................,,...............................,,,,.....................................,,.............,,.....................................,,.........,.............................,,...........,,.............................,........,,.......,,.,,,,..,,,,,,,,................,,,,,,,,,,,,,,..............................,.............................................................,,.............................................................................................,,.......,,,,,,................................................,,.,.,,,,,,.,,,,,.,,,.,,.,,,,,.............................................................,,............,,,,........................................................................................................................................,,,,.......................................,,,............................,...............,,............................,,,..........................................................,,................................................................,,,,,....,,,,,,,,................................................................................,............,,,,,,,,..............,,.,,..................,,.,.,....,.,............................,,,,,,,,,.................,,.....................,,...................,,,.............................,,..,................,,...............................,,................,,.......................,...........,.........,............,,.............,,.......................................,,.................................................................,,.......................,,................................................................................................................................................................,,..........................................,,.............................................................................................................................................................................................................,,,,..............................,.................,,.......................................................,,.............................................,,..............................,..,..,........................,..,,,,.....,,.............................................................,..,,,,.....,,.............................................................,..,,,,.....,,....................................................,............,..,,,,.....,,....................................................,........................,,,,,,..............................................,,...................................................,,,,,....................................,,,,.............,,.....................,....................,,,,,...........................,,....................,..................,,,....................,,,.........................................................,..........................................................,,..........................................................................................................................................,.,............................................,,.......................................,,...................................,,..........,.................................,.......................................,,.......,..................................................................................,,,,..................................,.............,,,..............................................................................,,,....................................................................................,........................,,,............,,,,..........,,,,..........,,,,..........,,,,..........,,,,............,,,,,............,,,.......................,,,,,,.........,,,,,,,,,,,,.................,,.........,,....,,..............................................,,..,,,,.....,,.......................................................,,,,.,,.,,..............,,,,,,..........,,,....,,,,..........,,.................,,,..................,,....................................,,......................................................................................,..........,,.....................................................,,...........................................,,.......................,............,...........................,,,,............................,,.................................,,.......................................,,............................................................................,...............,,..................................,............,,...................,.........................,,,,,,.....................................................,,,,,,.............................................,,.........................,............;......................................................................................................................................................................................................................................................................... 217/326:section:..."AST Attribute Descriptions" for node217.html ;............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,....................................................,,,,,,,,.................................................................................................................................................................,,,,................................................,,,,,,................................................................................................................................................................................................................,,.,,..............................,.....................................................................................................................................,,,,.,.,,,.,,.,,.,.,.,.,.,.,.,.,.,.,.,,.,,.,.,.........................................................................................................................................,,,,.,,.,,.........................,.........................................................................................................,.................................................................................................................................................................,............,.....................................................................................................................................................................................................................................................................................................................................,,,,..........................................................................,,,,...........................................................................................................................................................,,......................................................................................................................,...................................................................,,,,.....................................................................................................................,.........................................................................................................................................................................................................,............................................................................,...........................................,.............................................,...............................................................................................................................................................................................,,,,,,............................................,....................................................................,,............................................................................................................................................................................................................................................................................................................,....................................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,,,,,,,........................................,,,...............................................................................................................................................................................,.,.,,,.,,,.............,.............,,,,...........................................................................,,.........................................................................................................................................................,..............,,,,.....,,,,.................,................................,..............................................................................................................................................................................................................................................................................................................,,.,,,,,,.,,,,.,,..,,,,.,,.,,.,,,,.,,.,,.,,...,,.,,,,........................................................................................................................................................;........................................................................................................................................................................................................................... 218/326:section:..."AST Class Descriptions" for node218.html ;...........................................................................,,,....,,..................................................................................................................................................................................,,,,,,,,,,..........................................................................................................................,,,,..........,,,,......................................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,..,,,,.....,,,,.,,,,.,,,,...............................................................................................................,,,,.,,,,.,,,,.............................................................................................................,,,,.....................................................................................................................,,,,...,,,,.....,,,,.........................................................................,,,,.......................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,.............,..........................,,..............................................................,,,,..........................................................................................................................................................................................................................................................,............................,.........,...............,.........,.....................,,.....,,........................................................................................................................,,,,............................................................................................................................................................................................................................................................................................................................;................................................................... 219/326:section:..."UNIX Command Descriptions" for node219.html ;................................................................................................................................................................................................................................................................;... 220/326:section:..."AST Memory Management and Utility Functions" for node220.html ;.....,.........,..,,,,.,.........................,,,,.,.............................,,,,,,,,,........................................................................,................,................,,,...........................,......,.........,,..............,,..............,.......,,,,..,.............,,....,,,,...,............,,,,,,,.........,....,.............,,,,...,..........................,,,,,..,...,.,.,.,.,.,.,...................,.................................................................,......,,,....................................,,..........,,........,,.......................,.............,............................,,...............,......,............,,,...................,,.....................,,,,......................,...............;................................................ 221/326:section:...."FitsWcsCoverageFITS-WCS Coverage" for node221.html ;....;......... 222/326:subsection:.."Paper I - General Linear Coordinates" for node222.html ;..,,............................................................................;.......... 223/326:subsubsection:.."Requirements for a Successful Write Operation" for node223.html ;.;.... 224/326:subsubsection:..."Use and Choice of CTYPEi keywords" for node224.html ;..;............. 225/326:subsubsection:.."Choice of Reference Point" for node225.html ;.,...;.......... 226/326:subsubsection:.."Choice of Axis Ordering" for node226.html ;,,....;....... 227/326:subsubsection:.."Alternate Axis Descriptions" for node227.html ;..;..... 228/326:subsection:.."Paper II - Celestial Coordinates" for node228.html ;..,,.......................................................;....... 229/326:subsubsection:.."Requirements for a Successful Write Operation" for node229.html ;.,..;......... 230/326:subsubsection:.."Choice of LONPOLE/LATPOLE" for node230.html ;.,......,..;.................. 231/326:subsubsection:.."User Defined Fiducial Points" for node231.html ;....;.............. 232/326:subsubsection:.."Common Non-Standard Features" for node232.html ;.,..............;.................. 233/326:subsection:.."Paper III - Spectral Coordinates" for node233.html ;..,,,.........................................................................;....... 234/326:subsubsection:.."Requirements for a Successful Write Operation" for node234.html ;.,...;....... 235/326:subsubsection:.."Common Non-Standard Features" for node235.html ;.,.;. 236/326:subsection:.."Paper IV - Coordinate Distortions" for node236.html ;...;...... 237/326:subsubsection:.."The ``-SIP'' distortion code" for node237.html ;......;........ 238/326:section:...."changes_and_new_featuresRelease Notes" for node238.html ;.; 239/326:subsection:.."Changes Introduced in V1.1" for node239.html ;..,.............;........................................ 240/326:subsection:.."Changes Introduced in V1.2" for node240.html ;..,.,,,,.,,......,,.............;............................. 241/326:subsection:.."Changes Introduced in V1.3" for node241.html ;..,,,,,.........;..... 242/326:subsection:.."Changes Introduced in V1.4" for node242.html ;..,...............;............... 243/326:subsection:.."Changes Introduced in V1.5" for node243.html ;..,...,.....,........,..;..................................... 244/326:subsection:.."Changes Introduced in V1.6" for node244.html ;..,...........,,......;........................ 245/326:subsection:.."Changes Introduced in V1.7" for node245.html ;..,..,.,,...........;................ 246/326:subsection:.."Changes Introduced in V1.8-2" for node246.html ;..,,,,....;........... 247/326:subsection:.."Changes Introduced in V1.8-3" for node247.html ;..,...;.... 248/326:subsection:.."Changes Introduced in V1.8-4" for node248.html ;..,....;..... 249/326:subsection:.."Changes Introduced in V1.8-5" for node249.html ;..,..;.. 250/326:subsection:.."Changes Introduced in V1.8-7" for node250.html ;..,.....;....... 251/326:subsection:.."Changes Introduced in V1.8-8" for node251.html ;..,.....;........ 252/326:subsection:.."Changes Introduced in V1.8-13" for node252.html ;..,.........;................ 253/326:subsection:.."Changes Introduced in V2.0" for node253.html ;.,...,...............;.................................. 254/326:subsection:.."Changes Introduced in V3.0" for node254.html ;..,..,...............................;...................................... 255/326:subsection:.."Changes Introduced in V3.1" for node255.html ;..,..;... 256/326:subsection:.."Changes Introduced in V3.2" for node256.html ;..,...................;................... 257/326:subsection:.."Changes Introduced in V3.3" for node257.html ;..,..........;....... 258/326:subsection:.."Changes Introduced in V3.4" for node258.html ;..,........;........... 259/326:subsection:.."Changes Introduced in V3.5" for node259.html ;..,.........;............ 260/326:subsection:.."Changes Introduced in V3.6" for node260.html ;..,.......;........ 261/326:subsection:.."Changes Introduced in V3.7" for node261.html ;..,..;........ 262/326:subsection:.."Changes Introduced in V4.0" for node262.html ;..,...;.... 263/326:subsection:.."Changes Introduced in V4.1" for node263.html ;..,.,,........;.................. 264/326:subsection:.."Changes Introduced in V4.2" for node264.html ;..,..................;...................... 265/326:subsection:.."Changes Introduced in V4.3" for node265.html ;..,...;... 266/326:subsection:.."Changes Introduced in V4.4" for node266.html ;..,.........;..................... 267/326:subsection:.."Changes Introduced in V4.5" for node267.html ;..,.........;........... 268/326:subsection:.."Changes Introduced in V4.6" for node268.html ;..,.....;...... 269/326:subsection:.."Changes Introduced in V5.0" for node269.html ;..,.....;....... 270/326:subsection:.."Changes Introduced in V5.1" for node270.html ;..,...............;..................... 271/326:subsection:.."Changes Introduced in V5.2" for node271.html ;..,...........;................ 272/326:subsection:.."Changes Introduced in V5.3" for node272.html ;..,....;......... 273/326:subsection:.."Changes Introduced in V5.3-1" for node273.html ;..,.................;.................... 274/326:subsection:.."Changes Introduced in V5.3-2" for node274.html ;..,.......;....... 275/326:subsection:.."Changes Introduced in V5.4-0" for node275.html ;..,.......;....... 276/326:subsection:.."Changes Introduced in V5.5-0" for node276.html ;..,..;..... 277/326:subsection:.."Changes Introduced in V5.6-0" for node277.html ;..,......;....... 278/326:subsection:.."ChangesIntroduced in V5.6-1" for node278.html ;..,....;.... 279/326:subsection:.."Changes Introduced in V5.7-0" for node279.html ;..,.......;.... 280/326:subsection:.."Changes Introduced in V5.7-1" for node280.html ;..,....;....... 281/326:subsection:.."Changes Introduced in V5.7-2" for node281.html ;..,.........;........... 282/326:subsection:.."Changes Introduced in V6.0" for node282.html ;..,......;... 283/326:subsection:.."Changes Introduced in V6.0-1" for node283.html ;..,..,,..;.. 284/326:subsection:.."Changes Introduced in V7.0.0" for node284.html ;..,...;.. 285/326:subsection:.."Changes Introduced in V7.0.1" for node285.html ;..,..; 286/326:subsection:.."Changes Introduced in V7.0.2" for node286.html ;..,..;.. 287/326:subsection:.."Changes Introduced in V7.0.3" for node287.html ;..,......;..... 288/326:subsection:.."Changes Introduced in V7.0.4" for node288.html ;..,..; 289/326:subsection:.."Changes Introduced in V7.0.5" for node289.html ;..,..;.. 290/326:subsection:.."Changes Introduced in V7.0.6" for node290.html ;..,...;. 291/326:subsection:.."Changes Introduced in V7.1.0" for node291.html ;..,.....;......... 292/326:subsection:.."Changes Introduced in V7.1.1" for node292.html ;..,...;...... 293/326:subsection:.."Changes Introduced in V7.2.0" for node293.html ;..,..;.. 294/326:subsection:.."Changes Introduced in V7.3.0" for node294.html ;..,....;........ 295/326:subsection:.."Changes Introduced in V7.3.1" for node295.html ;..,..; 296/326:subsection:.."Changes Introduced in V7.3.2" for node296.html ;..,....;... 297/326:subsection:.."Changes Introduced in V7.3.3" for node297.html ;..,...;... 298/326:subsection:.."Changes Introduced in V7.3.4" for node298.html ;..,...;.. 299/326:subsection:.."Changes Introduced in V8.0.0" for node299.html ;..,.....;. 300/326:subsection:.."Changes Introduced in V8.0.1" for node300.html ;..,..;........ 301/326:subsection:.."Changes Introduced in V8.0.2" for node301.html ;.,.;.. 302/326:subsection:.."Changes Introduced in V8.0.3" for node302.html ;.,..;... 303/326:subsection:.."Changes Introduced in V8.0.4" for node303.html ;.,........;........... 304/326:subsection:.."Changes Introduced in V8.0.5" for node304.html ;.,....;...... 305/326:subsection:.."Changes Introduced in V8.1.0" for node305.html ;.,..; 306/326:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V8.2" for node306.html ;.,...;........ 307/326:subsection:.."Changes Introduced in V8.3" for node307.html ;.,...;... 308/326:subsection:.."Changes Introduced in V8.4" for node308.html ;.,..........;............ 309/326:subsection:.."Changes Introduced in V8.5" for node309.html ;.,.......;............... 310/326:subsection:.."Changes Introduced in V8.6.2" for node310.html ;.,.......;................. 311/326:subsection:.."Changes Introduced in V8.6.3" for node311.html ;.,.....;... 312/326:subsection:.."Changes Introduced in V8.7.0" for node312.html ;.,....;..... 313/326:subsection:.."Changes Introduced in V8.7.1" for node313.html ;.,...;..... 314/326:subsection:.."Changes Introduced in V8.7.2" for node314.html ;.,.....;.... 315/326:subsection:.."Changes Introduced in V9.0.0" for node315.html ;.,...;. 316/326:subsection:.."Changes Introduced in V9.0.2" for node316.html ;.,..;.... 317/326:subsection:.."Changes Introduced in V9.1.0" for node317.html ;.,....;.... 318/326:subsection:.."Changes Introduced in V9.1.2" for node318.html ;.,..;. 319/326:subsection:.."Changes Introduced in V9.1.3" for node319.html ;.,....;... 320/326:subsection:.."Changes Introduced in V9.2.0" for node320.html ;.,...;.. 321/326:subsection:.."Changes Introduced in V9.2.4" for node321.html ;.,.;....... 322/326:subsection:.."Changes Introduced in V9.2.5" for node322.html ;.,......;........ 323/326:subsection:.."Changes Introduced in V9.2.6" for node323.html ;.,..;. 324/326:subsection:.."Changes Introduced in V9.2.7" for node324.html ;.,..;.. 325/326:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V9.2.8" for node325.html ;.,....;.. 326/326:sectionstar:.."About this document ..." for node326.html ;;. . Doing footnotes ... Writing image file ... Translating images to PDF using pdflatex ... This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2025/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./images.tex LaTeX2e <2024-11-01> L3 programming layer <2024-11-02> *** LaTeX produced no output *** *** no new images can be created *** Examine the images.log file. *** LaTeXERROR Doing section links ................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ Copying navigation icons ... *** Adding document-specific styles *** *********** WARNINGS *********** No implementation found for style `starlink' Unknown commands: cleardoublepage htmladdnormallink htmladdnormallinkfoot htmlref includegraphics scfrontmatter sstapplicability sstattributetype sstdescription sstdiylist sstdiytopic sstexamples sstexamplesubsection sstinvocation sstitem sstitemlist sstnotes sstparameters sstreturnedvalue sstroutine sstsubsection stardocabstract stardocauthors stardoccategory stardoccopyright stardocdate stardocinitials stardocmanual stardocnumber stardocsource stardoctitle stardocversion startitlepic xlabel xref Done. rm -f sun211/sun211.html sun211/WARNINGS make[2]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_installdocs find debian -type f \( -name '*.log' -o -name '*.aux' \) -delete make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_installdocs -Nlibstarlink-ast-doc dh_installchangelogs dh_lintian dh_perl dh_link dh_strip_nondeterminism dh_compress dh_fixperms debian/rules override_dh_missing make[1]: Entering directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_missing --list-missing dh_missing: warning: usr/bin/ast_link exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/bin/ast_link_adam exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_err.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_2.0.so.9.2.10 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_3.2.so.9.2.10 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_grf_5.6.so.9.2.10 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pass2.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pass2.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pass2.so.9.2.10 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot.so.9.2.10 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/i386-linux-gnu/libstarlink_ast_pgplot3d.so.9.2.10 exists in debian/tmp but is not installed to anywhere The following debhelper tools have reported what they installed (with files per package) * dh_install: libstarlink-ast-dev (14), libstarlink-ast-doc (0), libstarlink-ast-err9 (2), libstarlink-ast-grf3d9 (2), libstarlink-ast9 (2) * dh_installdocs: libstarlink-ast-dev (0), libstarlink-ast-doc (345), libstarlink-ast-err9 (0), libstarlink-ast-grf3d9 (0), libstarlink-ast9 (0) If the missing files are installed by another tool, please file a bug against it. When filing the report, if the tool is not part of debhelper itself, please reference the "Logging helpers and dh_missing" section from the "PROGRAMMING" guide for debhelper (10.6.3+). (in the debhelper package: /usr/share/doc/debhelper/PROGRAMMING.md.gz) Be sure to test with dpkg-buildpackage -A/-B as the results may vary when only a subset is built If the omission is intentional or no other helper can take care of this consider adding the paths to debian/not-installed. Remember to be careful with paths containing "i386-linux-gnu", where you might need to use a wildcard or (assuming compat 13+) e.g. ${DEB_HOST_MULTIARCH} in debian/not-installed to ensure it works on all architectures (see #961104). make[1]: Leaving directory '/build/reproducible-path/starlink-ast-9.2.10+dfsg' dh_dwz -a dh_strip -a dh_makeshlibs -a dh_shlibdeps -a dpkg-shlibdeps: warning: symbol astErrorPublic_ used by debian/libstarlink-ast-grf3d9/usr/lib/i386-linux-gnu/libstarlink_ast_grf3d.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astGetStatusPtr_ used by debian/libstarlink-ast-err9/usr/lib/i386-linux-gnu/libstarlink_ast_err.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astPutErr_ used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astG3DFlush used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astGTxExt used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol atan2 used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astGCap used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol tanh used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astGText used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol fmod used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol cos used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: symbol astGBBuf used by debian/libstarlink-ast9/usr/lib/i386-linux-gnu/libstarlink_ast.so.9.2.10 found in none of the libraries dpkg-shlibdeps: warning: 28 other similar warnings have been skipped (use -v to see them all) dh_installdeb dh_gencontrol dpkg-gencontrol: warning: Depends field of package libstarlink-ast-grf3d9: substitution variable ${shlibs:Depends} used, but is not defined dpkg-gencontrol: warning: Depends field of package libstarlink-ast-grf3d9: substitution variable ${shlibs:Depends} used, but is not defined dh_md5sums dh_builddeb dpkg-deb: building package 'libstarlink-ast-dev' in '../libstarlink-ast-dev_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast9-dbgsym' in '../libstarlink-ast9-dbgsym_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast-grf3d9' in '../libstarlink-ast-grf3d9_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast-grf3d9-dbgsym' in '../libstarlink-ast-grf3d9-dbgsym_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast-err9' in '../libstarlink-ast-err9_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast9' in '../libstarlink-ast9_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast-err9-dbgsym' in '../libstarlink-ast-err9-dbgsym_9.2.10+dfsg-2_i386.deb'. dpkg-deb: building package 'libstarlink-ast-doc' in '../libstarlink-ast-doc_9.2.10+dfsg-2_all.deb'. dpkg-genbuildinfo --build=binary -O../starlink-ast_9.2.10+dfsg-2_i386.buildinfo dpkg-genchanges --build=binary -O../starlink-ast_9.2.10+dfsg-2_i386.changes dpkg-genchanges: info: binary-only upload (no source code included) dpkg-source --after-build . dpkg-buildpackage: info: binary-only upload (no source included) dpkg-genchanges: info: not including original source code in upload I: copying local configuration 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/33987 and its subdirectories I: Current time: Wed Nov 20 01:35:41 -12 2024 I: pbuilder-time-stamp: 1732109741 Wed Nov 20 13:35:43 UTC 2024 I: 1st build successful. Starting 2nd build on remote node ionos16-i386.debian.net. Wed Nov 20 13:35:43 UTC 2024 I: Preparing to do remote build '2' on ionos16-i386.debian.net. Wed Nov 20 13:44:50 UTC 2024 I: Deleting $TMPDIR on ionos16-i386.debian.net. Wed Nov 20 13:44:50 UTC 2024 I: starlink-ast_9.2.10+dfsg-2_i386.changes: Format: 1.8 Date: Sun, 06 Oct 2024 13:21:21 +0100 Source: starlink-ast Binary: libstarlink-ast-dev libstarlink-ast-doc libstarlink-ast-err9 libstarlink-ast-err9-dbgsym libstarlink-ast-grf3d9 libstarlink-ast-grf3d9-dbgsym libstarlink-ast9 libstarlink-ast9-dbgsym Architecture: i386 all Version: 9.2.10+dfsg-2 Distribution: unstable Urgency: medium Maintainer: Debian Astro Team Changed-By: Phil Wyett Description: libstarlink-ast-dev - Handle World Coordinate Systems in Astronomy (development package libstarlink-ast-doc - Handle World Coordinate Systems in Astronomy (documentation) libstarlink-ast-err9 - Handle World Coordinate Systems in Astronomy (error reporting) libstarlink-ast-grf3d9 - Handle World Coordinate Systems in Astronomy (dummy 3d routines) libstarlink-ast9 - Handle World Coordinate Systems in Astronomy (main shared lib) Closes: 1047627 Changes: starlink-ast (9.2.10+dfsg-2) unstable; urgency=medium . * Team upload. * 'd/clean': Add missing extensions. (Closes: #1047627) * 'd/control': Update 'Standards-Version' to 4.7.0, no changes required. * 'd/rules': Add hardening 'all'. * 'd/tests/run-test': Remove useless temporary directory, fixes tests. Checksums-Sha1: 91711e3f1c148fc4aab5ad22f20df92cd2b50aae 1964240 libstarlink-ast-dev_9.2.10+dfsg-2_i386.deb 7bbeb6966749ca849d85b124fd69d0997a170769 3132024 libstarlink-ast-doc_9.2.10+dfsg-2_all.deb cdcb89ee649e1e0c0baee548568042f1711820b2 3716 libstarlink-ast-err9-dbgsym_9.2.10+dfsg-2_i386.deb 81278af2918ff49fcb0cf755dec2b6df76f88085 5572 libstarlink-ast-err9_9.2.10+dfsg-2_i386.deb 0b7742034b784a42988f41b79c6f5ffe61b50036 3608 libstarlink-ast-grf3d9-dbgsym_9.2.10+dfsg-2_i386.deb 1866e6d5820341ececdc9dbfaefd1b94136300aa 5928 libstarlink-ast-grf3d9_9.2.10+dfsg-2_i386.deb b00120fda07a499caac33b81c26fb067b97ec60a 5386432 libstarlink-ast9-dbgsym_9.2.10+dfsg-2_i386.deb d661cf5315c553397279c44c654fe640007f0222 1799580 libstarlink-ast9_9.2.10+dfsg-2_i386.deb cee9888cd08e4aabed1fbc93aa29de5df588299d 11959 starlink-ast_9.2.10+dfsg-2_i386.buildinfo Checksums-Sha256: 924c7f8b06066c692029c7a473c6f7fdc5fbacd15ab3018e3c2e4503fafc9c55 1964240 libstarlink-ast-dev_9.2.10+dfsg-2_i386.deb b60ec0d5979478cfd7bd6ca1ce71bc2586d1fe18b0271fec1fe9a9122cb76d1c 3132024 libstarlink-ast-doc_9.2.10+dfsg-2_all.deb 72c67d453e63f2e8f98cb674ecf09fd72c2c2ace870af4aedf38cc1b8fe932d0 3716 libstarlink-ast-err9-dbgsym_9.2.10+dfsg-2_i386.deb 71a6b3d9237394ee77852f74fbba8475a5ee04847213665c928feb03cc5746c3 5572 libstarlink-ast-err9_9.2.10+dfsg-2_i386.deb dc2ac8b15cb52e1e655769a14a07f7058dcf16ad63af89e0693d59add8cd156f 3608 libstarlink-ast-grf3d9-dbgsym_9.2.10+dfsg-2_i386.deb 71ab29fadcbe63e78c0a226ec0116515ec8e3f0568ea985f57b195d06761c7ef 5928 libstarlink-ast-grf3d9_9.2.10+dfsg-2_i386.deb 350871351738c375660837d3b323c0cbacffad681115ccb611f2bfcdd2ca4a7d 5386432 libstarlink-ast9-dbgsym_9.2.10+dfsg-2_i386.deb 7542c0d6e74d75be8b335e6208c478076f7025ce563111d992324ab6753ac081 1799580 libstarlink-ast9_9.2.10+dfsg-2_i386.deb 727660c95d0f26c8f01cea526e857597ddef1a4578ddadad7de62bb5d6ddb918 11959 starlink-ast_9.2.10+dfsg-2_i386.buildinfo Files: 4eb03955df8fb1518ce60ad62d531651 1964240 libdevel optional libstarlink-ast-dev_9.2.10+dfsg-2_i386.deb cafbe392c40d06bff51ef92251310023 3132024 doc optional libstarlink-ast-doc_9.2.10+dfsg-2_all.deb 645f0a0c76a219f0445843e8f09964f2 3716 debug optional libstarlink-ast-err9-dbgsym_9.2.10+dfsg-2_i386.deb 9084e5f5770c20d54764a2b685c0cb34 5572 libs optional libstarlink-ast-err9_9.2.10+dfsg-2_i386.deb 87c68012e281124b79f0778c8b8a151c 3608 debug optional libstarlink-ast-grf3d9-dbgsym_9.2.10+dfsg-2_i386.deb 723178badee22ae916cf60fa0cdcdccb 5928 libs optional libstarlink-ast-grf3d9_9.2.10+dfsg-2_i386.deb 331861b489dbd11b43507259927ea996 5386432 debug optional libstarlink-ast9-dbgsym_9.2.10+dfsg-2_i386.deb b53e9cc0f395fb5db0aa030bb6eab160 1799580 libs optional libstarlink-ast9_9.2.10+dfsg-2_i386.deb d82dd3dc9f768e68efe267684812f5e3 11959 science optional starlink-ast_9.2.10+dfsg-2_i386.buildinfo Wed Nov 20 13:44:52 UTC 2024 I: diffoscope 283 will be used to compare the two builds: Running as unit: rb-diffoscope-i386_12-29576.service # Profiling output for: /usr/bin/diffoscope --timeout 7200 --html /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/starlink-ast_9.2.10+dfsg-2.diffoscope.html --text /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/starlink-ast_9.2.10+dfsg-2.diffoscope.txt --json /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/starlink-ast_9.2.10+dfsg-2.diffoscope.json --profile=- /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/b1/starlink-ast_9.2.10+dfsg-2_i386.changes /srv/reproducible-results/rbuild-debian/r-b-build.Itkf182l/b2/starlink-ast_9.2.10+dfsg-2_i386.changes ## command (total time: 0.000s) 0.000s 1 call cmp (internal) ## has_same_content_as (total time: 0.000s) 0.000s 1 call abc.DotChangesFile ## main (total time: 0.434s) 0.434s 2 calls outputs 0.000s 1 call cleanup ## recognizes (total time: 0.124s) 0.124s 12 calls diffoscope.comparators.binary.FilesystemFile ## specialize (total time: 0.000s) 0.000s 1 call specialize Finished with result: success Main processes terminated with: code=exited/status=0 Service runtime: 728ms CPU time consumed: 729ms Wed Nov 20 13:44:53 UTC 2024 I: diffoscope 283 found no differences in the changes files, and a .buildinfo file also exists. Wed Nov 20 13:44:53 UTC 2024 I: starlink-ast from unstable built successfully and reproducibly on i386. Wed Nov 20 13:44:54 UTC 2024 I: Submitting .buildinfo files to external archives: Wed Nov 20 13:44:54 UTC 2024 I: Submitting 16K b1/starlink-ast_9.2.10+dfsg-2_i386.buildinfo.asc Wed Nov 20 13:44:57 UTC 2024 I: Submitting 16K b2/starlink-ast_9.2.10+dfsg-2_i386.buildinfo.asc Wed Nov 20 13:44:57 UTC 2024 I: Done submitting .buildinfo files to http://buildinfo.debian.net/api/submit. Wed Nov 20 13:44:57 UTC 2024 I: Done submitting .buildinfo files. Wed Nov 20 13:44:57 UTC 2024 I: Removing signed starlink-ast_9.2.10+dfsg-2_i386.buildinfo.asc files: removed './b1/starlink-ast_9.2.10+dfsg-2_i386.buildinfo.asc' removed './b2/starlink-ast_9.2.10+dfsg-2_i386.buildinfo.asc'