Input buildinfo: https://buildinfos.debian.net/buildinfo-pool/s/starlink-ast/starlink-ast_9.2.3+dfsg-1_all.buildinfo Use metasnap for getting required timestamps New buildinfo file: /tmp/starlink-ast-9.2.3+dfsg-1xtfm0wu3/starlink-ast_9.2.3+dfsg-1_all.buildinfo Get source package info: starlink-ast=9.2.3+dfsg-1 Source URL: http://snapshot.notset.fr/mr/package/starlink-ast/9.2.3+dfsg-1/srcfiles?fileinfo=1 env -i PATH=/usr/sbin:/usr/bin:/sbin:/bin TMPDIR=/tmp mmdebstrap --arch=amd64 --include=autoconf=2.69-11.1 automake=1:1.16.2-4 autopoint=0.19.8.1-10 autotools-dev=20180224.1 base-files=11 base-passwd=3.5.47 bash=5.0-7 binutils=2.35.1-1 binutils-common=2.35.1-1 binutils-x86-64-linux-gnu=2.35.1-1 bsdextrautils=2.36-3+b1 bsdutils=1:2.36-3+b1 build-essential=12.8 bzip2=1.0.8-4 coreutils=8.32-4+b1 cpp=4:10.2.0-1 cpp-10=10.2.0-13 dash=0.5.10.2-7 debconf=1.5.74 debhelper=13.2.1 debianutils=4.11.2 dh-autoreconf=19 dh-strip-nondeterminism=1.9.0-1 diffutils=1:3.7-3 dpkg=1.20.5 dpkg-dev=1.20.5 dwz=0.13-5 file=1:5.38-5 findutils=4.7.0-1 fontconfig-config=2.13.1-4.2 fonts-gfs-baskerville=1.1-6 fonts-gfs-porson=1.1-7 fonts-lmodern=2.004.5-6 fonts-urw-base35=20200910-1 g++=4:10.2.0-1 g++-10=10.2.0-13 gcc=4:10.2.0-1 gcc-10=10.2.0-13 gcc-10-base=10.2.0-13 gettext=0.19.8.1-10 gettext-base=0.19.8.1-10 ghostscript=9.53.3~dfsg-1 ghostscript-x=9.53.3~dfsg-1 grep=3.4-1 groff-base=1.22.4-5 gzip=1.10-2 hostname=3.23 init-system-helpers=1.58 intltool-debian=0.35.0+20060710.5 latex2html=2020.2-debian1-1 libacl1=2.2.53-8 libapache-pom-java=18-1 libarchive-zip-perl=1.68-1 libasan6=10.2.0-13 libatomic1=10.2.0-13 libattr1=1:2.4.48-5 libaudit-common=1:2.8.5-3 libaudit1=1:2.8.5-3+b1 libavahi-client3=0.8-3 libavahi-common-data=0.8-3 libavahi-common3=0.8-3 libbinutils=2.35.1-1 libblkid1=2.36-3+b1 libbrotli1=1.0.9-2 libbsd0=0.10.0-1 libbz2-1.0=1.0.8-4 libc-bin=2.31-3 libc-dev-bin=2.31-3 libc6=2.31-3 libc6-dev=2.31-3 libcairo2=1.16.0-4 libcap-ng0=0.7.9-2.2 libcc1-0=10.2.0-13 libcminpack-dev=1.3.6-4 libcminpack1=1.3.6-4 libcom-err2=1.45.6-1 libcommons-logging-java=1.2-2 libcommons-parent-java=43-1 libcroco3=0.6.13-1 libcrypt-dev=1:4.4.17-1 libcrypt1=1:4.4.17-1 libctf-nobfd0=2.35.1-1 libctf0=2.35.1-1 libcups2=2.3.3-3 libdb5.3=5.3.28+dfsg1-0.6 libdbus-1-3=1.12.20-1 libdebconfclient0=0.254 libdebhelper-perl=13.2.1 libdpkg-perl=1.20.5 libelf1=0.181-1 liberfa-dev=1.7.1-1 liberfa1=1.7.1-1 libexpat1=2.2.10-1 libffi7=3.3-4 libfile-stripnondeterminism-perl=1.9.0-1 libfontbox-java=1:1.8.16-2 libfontconfig1=2.13.1-4.2 libfreetype6=2.10.2+dfsg-3 libgcc-10-dev=10.2.0-13 libgcc-s1=10.2.0-13 libgcrypt20=1.8.6-2 libgdbm-compat4=1.18.1-5.1 libgdbm6=1.18.1-5.1 libglib2.0-0=2.66.0-2 libgmp10=2:6.2.0+dfsg-6 libgnutls30=3.6.15-4 libgomp1=10.2.0-13 libgpg-error0=1.38-2 libgraphite2-3=1.3.14-1 libgs9=9.53.3~dfsg-1 libgs9-common=9.53.3~dfsg-1 libgssapi-krb5-2=1.17-10 libharfbuzz0b=2.6.7-1 libhogweed6=3.6-2 libice6=2:1.0.10-1 libicu67=67.1-4 libidn11=1.33-2.4 libidn2-0=2.3.0-1 libijs-0.35=0.35-15 libisl22=0.22.1-1 libitm1=10.2.0-13 libjbig0=2.1-3.1+b2 libjbig2dec0=0.19-1 libjpeg62-turbo=1:2.0.5-1.1 libk5crypto3=1.17-10 libkeyutils1=1.6.1-2 libkpathsea6=2020.20200327.54578-5 libkrb5-3=1.17-10 libkrb5support0=1.17-10 liblcms2-2=2.9-4+b1 liblsan0=10.2.0-13 liblz4-1=1.9.2-2 liblzma5=5.2.4-1+b1 libmagic-mgc=1:5.38-5 libmagic1=1:5.38-5 libmount1=2.36-3+b1 libmpc3=1.2.0-1 libmpfr6=4.1.0-3 libncursesw6=6.2+20200918-1 libnetpbm10=2:10.0-15.3+b2 libnettle8=3.6-2 libnspr4=2:4.28-1 libnss3=2:3.56-1 libopenjp2-7=2.3.1-1 libp11-kit0=0.23.21-2 libpam-modules=1.3.1-5 libpam-modules-bin=1.3.1-5 libpam-runtime=1.3.1-5 libpam0g=1.3.1-5 libpaper-utils=1.1.28+b1 libpaper1=1.1.28+b1 libpcre2-8-0=10.34-7 libpcre3=2:8.39-13 libpdfbox-java=1:1.8.16-2 libperl5.30=5.30.3-4 libpipeline1=1.5.3-1 libpixman-1-0=0.36.0-1 libpng16-16=1.6.37-3 libpoppler102=20.09.0-2 libptexenc1=2020.20200327.54578-5 libpython3-stdlib=3.8.2-3 libpython3.8-minimal=3.8.6-1 libpython3.8-stdlib=3.8.6-1 libquadmath0=10.2.0-13 libreadline8=8.0-4 libseccomp2=2.4.4-1 libselinux1=3.1-2 libsigsegv2=2.12-2 libsm6=2:1.2.3-1 libsmartcols1=2.36-3+b1 libsqlite3-0=3.33.0-1 libssl1.1=1.1.1g-1 libstarlink-pal-dev=0.9.8-1 libstarlink-pal0=0.9.8-1 libstdc++-10-dev=10.2.0-13 libstdc++6=10.2.0-13 libsub-override-perl=0.09-2 libsynctex2=2020.20200327.54578-5 libsystemd0=246.6-1 libtasn1-6=4.16.0-2 libteckit0=2.5.10+ds1-3 libtexlua53=2020.20200327.54578-5 libtexluajit2=2020.20200327.54578-5 libtiff5=4.1.0+git191117-2 libtinfo6=6.2+20200918-1 libtool=2.4.6-14 libtsan0=10.2.0-13 libubsan1=10.2.0-13 libuchardet0=0.0.7-1 libudev1=246.6-1 libunistring2=0.9.10-4 libuuid1=2.36-3+b1 libwebp6=0.6.1-2+b1 libx11-6=2:1.6.12-1 libx11-data=2:1.6.12-1 libxau6=1:1.0.8-1+b2 libxaw7=2:1.0.13-1+b2 libxcb-render0=1.14-2 libxcb-shm0=1.14-2 libxcb1=1.14-2 libxdmcp6=1:1.1.2-3 libxext6=2:1.3.3-1+b2 libxi6=2:1.7.10-1 libxml2=2.9.10+dfsg-6 libxmu6=2:1.1.2-2+b3 libxpm4=1:3.5.12-1 libxrender1=1:0.9.10-1 libxt6=1:1.2.0-1 libzstd1=1.4.5+dfsg-4 libzzip-0-13=0.13.62-3.2 linux-libc-dev=5.8.10-1 login=1:4.8.1-1 lsb-base=11.1.0 m4=1.4.18-4 make=4.3-4 man-db=2.9.3-2 mawk=1.3.4.20200120-2 mime-support=3.64 ncurses-base=6.2+20200918-1 ncurses-bin=6.2+20200918-1 netpbm=2:10.0-15.3+b2 patch=2.7.6-6 perl=5.30.3-4 perl-base=5.30.3-4 perl-doc=5.30.3-4 perl-modules-5.30=5.30.3-4 po-debconf=1.0.21 poppler-data=0.4.9-2 poppler-utils=20.09.0-2 preview-latex-style=12.2-1 python3=3.8.2-3 python3-minimal=3.8.2-3 python3.8=3.8.6-1 python3.8-minimal=3.8.6-1 readline-common=8.0-4 sed=4.7-1 sensible-utils=0.0.12+nmu1 sysvinit-utils=2.96-5 t1utils=1.41-4 tar=1.30+dfsg-7 tex-common=6.15 texlive=2020.20200925-1 texlive-base=2020.20200925-1 texlive-binaries=2020.20200327.54578-5 texlive-font-utils=2020.20200925-1 texlive-fonts-recommended=2020.20200925-1 texlive-lang-greek=2020.20200925-1 texlive-latex-base=2020.20200925-1 texlive-latex-extra=2020.20200925-1 texlive-latex-recommended=2020.20200925-1 texlive-pictures=2020.20200925-1 texlive-science=2020.20200925-1 ucf=3.0043 util-linux=2.36-3+b1 x11-common=1:7.7+20 xdg-utils=1.1.3-2 xz-utils=5.2.4-1+b1 zlib1g=1:1.2.11.dfsg-2 --variant=apt --aptopt=Acquire::Check-Valid-Until "false" --aptopt=Acquire::http::Dl-Limit "1000"; --aptopt=Acquire::https::Dl-Limit "1000"; --aptopt=Acquire::Retries "5"; --aptopt=APT::Get::allow-downgrades "true"; --keyring=/usr/share/keyrings/ --essential-hook=chroot "$1" sh -c "apt-get --yes install fakeroot util-linux" --essential-hook=copy-in /usr/share/keyrings/debian-archive-bullseye-automatic.gpg /usr/share/keyrings/debian-archive-bullseye-security-automatic.gpg /usr/share/keyrings/debian-archive-bullseye-stable.gpg /usr/share/keyrings/debian-archive-buster-automatic.gpg /usr/share/keyrings/debian-archive-buster-security-automatic.gpg /usr/share/keyrings/debian-archive-buster-stable.gpg /usr/share/keyrings/debian-archive-keyring.gpg /usr/share/keyrings/debian-archive-removed-keys.gpg /usr/share/keyrings/debian-archive-stretch-automatic.gpg /usr/share/keyrings/debian-archive-stretch-security-automatic.gpg /usr/share/keyrings/debian-archive-stretch-stable.gpg /usr/share/keyrings/debian-ports-archive-keyring-removed.gpg /usr/share/keyrings/debian-ports-archive-keyring.gpg /usr/share/keyrings/debian-keyring.gpg /etc/apt/trusted.gpg.d/ --essential-hook=chroot "$1" sh -c "rm /etc/apt/sources.list && echo 'deb http://snapshot.notset.fr/archive/debian/20210814T212851Z/ bookworm main deb-src http://snapshot.notset.fr/archive/debian/20210814T212851Z/ bookworm main deb http://snapshot.notset.fr/archive/debian/20201006T083840Z/ unstable main' >> /etc/apt/sources.list && apt-get update" --customize-hook=chroot "$1" useradd --no-create-home -d /nonexistent -p "" builduser -s /bin/bash --customize-hook=chroot "$1" env sh -c "apt-get source --only-source -d starlink-ast=9.2.3+dfsg-1 && mkdir -p /build/starlink-ast-EXokvp && dpkg-source --no-check -x /*.dsc /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg && chown -R builduser:builduser /build/starlink-ast-EXokvp" --customize-hook=chroot "$1" env --unset=TMPDIR runuser builduser -c "cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg && env DEB_BUILD_OPTIONS="parallel=4" LC_ALL="C.UTF-8" SOURCE_DATE_EPOCH="1601978007" dpkg-buildpackage -uc -a amd64 --build=all" --customize-hook=sync-out /build/starlink-ast-EXokvp /tmp/starlink-ast-9.2.3+dfsg-1xtfm0wu3 bullseye /dev/null deb http://snapshot.notset.fr/archive/debian/20201006T083840Z unstable main I: automatically chosen mode: root I: chroot architecture amd64 is equal to the host's architecture I: automatically chosen format: tar I: using /tmp/mmdebstrap.DR52AIoVV5 as tempdir I: running apt-get update... I: downloading packages with apt... I: extracting archives... I: installing essential packages... I: running --essential-hook in shell: sh -c 'chroot "$1" sh -c "apt-get --yes install fakeroot util-linux"' exec /tmp/mmdebstrap.DR52AIoVV5 Reading package lists... Building dependency tree... util-linux is already the newest version (2.36-3+b1). The following NEW packages will be installed: fakeroot libfakeroot 0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded. Need to get 134 kB of archives. After this operation, 395 kB of additional disk space will be used. Get:1 http://snapshot.notset.fr/archive/debian/20201006T083840Z unstable/main amd64 libfakeroot amd64 1.25.2-1 [46.9 kB] Get:2 http://snapshot.notset.fr/archive/debian/20201006T083840Z unstable/main amd64 fakeroot amd64 1.25.2-1 [86.8 kB] debconf: delaying package configuration, since apt-utils is not installed Fetched 134 kB in 0s (781 kB/s) Selecting previously unselected package libfakeroot:amd64. (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 ... 4582 files and directories currently installed.) Preparing to unpack .../libfakeroot_1.25.2-1_amd64.deb ... Unpacking libfakeroot:amd64 (1.25.2-1) ... Selecting previously unselected package fakeroot. Preparing to unpack .../fakeroot_1.25.2-1_amd64.deb ... Unpacking fakeroot (1.25.2-1) ... Setting up libfakeroot:amd64 (1.25.2-1) ... Setting up fakeroot (1.25.2-1) ... update-alternatives: using /usr/bin/fakeroot-sysv to provide /usr/bin/fakeroot (fakeroot) in auto mode Processing triggers for libc-bin (2.31-3) ... I: running special hook: copy-in /usr/share/keyrings/debian-archive-bullseye-automatic.gpg /usr/share/keyrings/debian-archive-bullseye-security-automatic.gpg /usr/share/keyrings/debian-archive-bullseye-stable.gpg /usr/share/keyrings/debian-archive-buster-automatic.gpg /usr/share/keyrings/debian-archive-buster-security-automatic.gpg /usr/share/keyrings/debian-archive-buster-stable.gpg /usr/share/keyrings/debian-archive-keyring.gpg /usr/share/keyrings/debian-archive-removed-keys.gpg /usr/share/keyrings/debian-archive-stretch-automatic.gpg /usr/share/keyrings/debian-archive-stretch-security-automatic.gpg /usr/share/keyrings/debian-archive-stretch-stable.gpg /usr/share/keyrings/debian-ports-archive-keyring-removed.gpg /usr/share/keyrings/debian-ports-archive-keyring.gpg /usr/share/keyrings/debian-keyring.gpg /etc/apt/trusted.gpg.d/ I: running --essential-hook in shell: sh -c 'chroot "$1" sh -c "rm /etc/apt/sources.list && echo 'deb http://snapshot.notset.fr/archive/debian/20210814T212851Z/ bookworm main deb-src http://snapshot.notset.fr/archive/debian/20210814T212851Z/ bookworm main deb http://snapshot.notset.fr/archive/debian/20201006T083840Z/ unstable main' >> /etc/apt/sources.list && apt-get update"' exec /tmp/mmdebstrap.DR52AIoVV5 Get:1 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm InRelease [81.6 kB] Hit:2 http://snapshot.notset.fr/archive/debian/20201006T083840Z unstable InRelease Ign:3 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main Sources Ign:4 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main amd64 Packages Ign:3 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main Sources Ign:4 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main amd64 Packages Ign:3 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main Sources Ign:4 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main amd64 Packages Get:3 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main Sources [11.4 MB] Get:4 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main amd64 Packages [11.1 MB] Fetched 22.6 MB in 20s (1111 kB/s) Reading package lists... I: installing remaining packages inside the chroot... I: running --customize-hook in shell: sh -c 'chroot "$1" useradd --no-create-home -d /nonexistent -p "" builduser -s /bin/bash' exec /tmp/mmdebstrap.DR52AIoVV5 I: running --customize-hook in shell: sh -c 'chroot "$1" env sh -c "apt-get source --only-source -d starlink-ast=9.2.3+dfsg-1 && mkdir -p /build/starlink-ast-EXokvp && dpkg-source --no-check -x /*.dsc /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg && chown -R builduser:builduser /build/starlink-ast-EXokvp"' exec /tmp/mmdebstrap.DR52AIoVV5 Reading package lists... NOTICE: 'starlink-ast' packaging is maintained in the 'Git' version control system at: https://salsa.debian.org/debian-astro-team/starlink-ast.git Please use: git clone https://salsa.debian.org/debian-astro-team/starlink-ast.git to retrieve the latest (possibly unreleased) updates to the package. Need to get 3851 kB of source archives. Get:1 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main starlink-ast 9.2.3+dfsg-1 (dsc) [2545 B] Get:2 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main starlink-ast 9.2.3+dfsg-1 (tar) [3827 kB] Get:3 http://snapshot.notset.fr/archive/debian/20210814T212851Z bookworm/main starlink-ast 9.2.3+dfsg-1 (diff) [21.2 kB] Fetched 3851 kB in 3s (1163 kB/s) Download complete and in download only mode W: Download is performed unsandboxed as root as file 'starlink-ast_9.2.3+dfsg-1.dsc' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied) dpkg-source: info: extracting starlink-ast in /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg dpkg-source: info: unpacking starlink-ast_9.2.3+dfsg.orig.tar.xz dpkg-source: info: unpacking starlink-ast_9.2.3+dfsg-1.debian.tar.xz dpkg-source: info: using patch list from debian/patches/series dpkg-source: info: applying Rename-library.patch dpkg-source: info: applying use_std_automake.patch dpkg-source: info: applying The-external-PAL-library-in-Debian-is-called-starlink-pal.patch dpkg-source: info: applying Use-cminpack-provided-by-Debian.patch dpkg-source: info: applying workround_armhf_compiler_bug.patch dpkg-source: info: applying Disable-tests.patch dpkg-source: info: applying Check-the-values-returned-by-the-test.patch I: running --customize-hook in shell: sh -c 'chroot "$1" env --unset=TMPDIR runuser builduser -c "cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg && env DEB_BUILD_OPTIONS="parallel=4" LC_ALL="C.UTF-8" SOURCE_DATE_EPOCH="1601978007" dpkg-buildpackage -uc -a amd64 --build=all"' exec /tmp/mmdebstrap.DR52AIoVV5 dpkg-buildpackage: info: source package starlink-ast dpkg-buildpackage: info: source version 9.2.3+dfsg-1 dpkg-buildpackage: info: source distribution unstable dpkg-buildpackage: info: source changed by Ole Streicher dpkg-source --before-build . debian/rules clean dh clean --with autoreconf dh_clean debian/rules binary-indep dh binary-indep --with autoreconf dh_update_autotools_config -i debian/rules override_dh_autoreconf make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' cp ast.news NEWS dh_autoreconf libtoolize: putting auxiliary files in AC_CONFIG_AUX_DIR, 'build-aux'. libtoolize: copying file 'build-aux/ltmain.sh' libtoolize: Consider adding 'AC_CONFIG_MACRO_DIRS([m4])' to configure.ac, libtoolize: and rerunning libtoolize and aclocal. libtoolize: Consider adding '-I m4' to ACLOCAL_AMFLAGS in Makefile.am. configure.ac:36: installing 'build-aux/compile' configure.ac:27: installing 'build-aux/missing' Makefile.am: installing 'build-aux/depcomp' Makefile.am:710: warning: variable 'libstarlink_ast_drama_la_SOURCES' is defined but no program or Makefile.am:710: library has 'libstarlink_ast_drama_la' as canonical name (possible typo) Makefile.am:706: warning: variable 'libstarlink_ast_ems_la_SOURCES' is defined but no program or Makefile.am:706: library has 'libstarlink_ast_ems_la' as canonical name (possible typo) Makefile.am:711: warning: variable 'libstarlink_ast_drama_la_LDFLAGS' is defined but no program or Makefile.am:711: library has 'libstarlink_ast_drama_la' as canonical name (possible typo) Makefile.am:707: warning: variable 'libstarlink_ast_ems_la_LDFLAGS' is defined but no program or Makefile.am:707: library has 'libstarlink_ast_ems_la' as canonical name (possible typo) make[1]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' debian/rules override_dh_auto_configure make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_auto_configure -- --with-external_pal ./configure --build=x86_64-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/x86_64-linux-gnu --runstatedir=/run --disable-maintainer-mode --disable-dependency-tracking --with-external_pal checking for a BSD-compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking for a thread-safe mkdir -p... /bin/mkdir -p checking for gawk... no checking for mawk... mawk checking whether make sets $(MAKE)... yes checking whether make supports nested variables... yes checking for gcc... gcc checking whether the C compiler works... yes checking for C compiler default output file name... a.out checking for suffix of executables... checking whether we are cross compiling... no checking for suffix of object files... o checking whether we are using the GNU C compiler... yes checking whether gcc accepts -g... yes checking for gcc option to accept ISO C89... none needed checking whether gcc understands -c and -o together... yes checking whether make supports the include directive... yes (GNU style) checking dependency style of gcc... none checking how to run the C preprocessor... gcc -E checking build system type... x86_64-pc-linux-gnu checking host system type... x86_64-pc-linux-gnu checking how to print strings... printf checking for a sed that does not truncate output... /bin/sed checking for grep that handles long lines and -e... /bin/grep checking for egrep... /bin/grep -E checking for fgrep... /bin/grep -F checking for ld used by gcc... /usr/bin/ld checking if the linker (/usr/bin/ld) is GNU ld... yes checking for BSD- or MS-compatible name lister (nm)... /usr/bin/nm -B checking the name lister (/usr/bin/nm -B) interface... BSD nm checking whether ln -s works... yes checking the maximum length of command line arguments... 1572864 checking how to convert x86_64-pc-linux-gnu file names to x86_64-pc-linux-gnu format... func_convert_file_noop checking how to convert x86_64-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 objdump... objdump checking how to recognize dependent libraries... pass_all checking for dlltool... no checking how to associate runtime and link libraries... printf %s\n checking for ar... ar checking for archiver @FILE support... @ checking for strip... strip checking for ranlib... ranlib checking command to parse /usr/bin/nm -B output from gcc object... ok checking for sysroot... no checking for a working dd... /bin/dd checking how to truncate binary pipes... /bin/dd bs=4096 count=1 checking for mt... no checking if : is a manifest tool... no checking for ANSI C header files... yes checking for sys/types.h... yes checking for sys/stat.h... yes checking for stdlib.h... yes checking for string.h... yes checking for memory.h... yes checking for strings.h... yes checking for inttypes.h... yes checking for stdint.h... yes checking for unistd.h... yes checking for dlfcn.h... yes checking for objdir... .libs checking if gcc supports -fno-rtti -fno-exceptions... no checking for gcc option to produce PIC... -fPIC -DPIC checking if gcc PIC flag -fPIC -DPIC works... yes checking if gcc static flag -static works... yes checking if gcc supports -c -o file.o... yes checking if gcc supports -c -o file.o... (cached) yes checking whether the gcc linker (/usr/bin/ld -m elf_x86_64) 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 9213: ,: 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 we are using the GNU Fortran compiler... no checking whether accepts -g... no checking how to get verbose linking output from ... configure: WARNING: compilation failed checking for Fortran libraries of ... checking for pthread_create in -lpthread... yes checking for yaml_parser_initialize in -lyaml... no checking stdarg.h usability... yes checking stdarg.h presence... yes checking for stdarg.h... yes checking execinfo.h usability... yes checking execinfo.h presence... yes checking for execinfo.h... yes checking for backtrace... yes checking for strerror_r... yes checking for strtok_r... yes checking for vsnprintf... yes checking for long double... yes checking for int64_t... yes checking for uint64_t... yes checking size of long... 8 checking size of long long... 8 checking whether C compiler defines __func__... yes checking for perl... /usr/bin/perl checking for isnan... yes checking whether isnan is declared... yes checking for isfinite... no checking whether isfinite is declared... yes checking whether the sscanf function is ANSI-compatible... yes checking that generated files are newer than configure... done configure: creating ./config.status config.status: creating Makefile config.status: creating component.xml config.status: creating ast_link config.status: creating ast_link_adam config.status: creating 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/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_auto_build -i make -j4 make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make all-am make[2]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/axis.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-axis.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/circle.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-circle.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-cmpframe.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-cmpmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/cmpregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-cmpregion.o src/cmpframe.c: In function ‘GetAttrib’: src/cmpframe.c:3289:32: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] 3289 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~ src/cmpframe.c:3289:28: note: directive argument in the range [-2147483647, 2147483647] 3289 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 4 and 93 bytes into a destination of size 80 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/cmpframe.c: In function ‘TestAttrib’: src/cmpframe.c:9614:35: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] 9614 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~ src/cmpframe.c:9614:31: note: directive argument in the range [-2147483647, 2147483647] 9614 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 4 and 93 bytes into a destination of size 80 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/cmpframe.c: In function ‘SetAttrib.part.0’: src/cmpframe.c:8308:21: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size between 0 and 1023 [-Wformat-overflow=] 8308 | nc = sprintf( buf2, "%s(%d)=%s", buf1, paxis + 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 8309 | setting+value ); | ~~~~~~~~~~~~~~~ src/cmpframe.c:8308:21: note: directive argument in the range [-2147483647, 2147483647] In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output 5 or more bytes (assuming 1038) into a destination of size 1024 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/cmpframe.c:8322:43: warning: ‘__builtin___sprintf_chk’ may write a terminating nul past the end of the destination [-Wformat-overflow=] 8322 | sprintf( buf2, "%s=%s", buf1, setting+value ); | ^ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output 2 or more bytes (assuming 1025) into a destination of size 1024 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/cmpframe.c: In function ‘ClearAttrib’: src/cmpframe.c:1612:35: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size between 0 and 79 [-Wformat-overflow=] 1612 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~ src/cmpframe.c:1612:31: note: directive argument in the range [-2147483647, 2147483647] 1612 | sprintf( buf2, "%s(%d)", buf1, paxis + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 4 and 93 bytes into a destination of size 80 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ellipse.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ellipse.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/error.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-error.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fitschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fitschan.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fluxframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fluxframe.o 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 ); | ^~ 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:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 14 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 ); | ^~ src/fitstable.c:2277:28: note: directive argument in the range [1, 2147483647] 2277 | sprintf( keyword, "TTYPE%d", icol ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 14 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 ); | ^~ src/fitstable.c:2282:31: note: directive argument in the range [1, 2147483647] 2282 | sprintf( keyword, "TUNIT%d", icol ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 14 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 ); | ^~ src/fitstable.c:2293:34: note: directive argument in the range [1, 2147483647] 2293 | sprintf( keyword, "TNULL%d", icol ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 14 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 file included from /usr/include/stdio.h:867, 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: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 6 and 15 bytes into a destination of size 14 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/frameset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-frameset.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/grismmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-grismmap.o src/fitschan.c: In function ‘IsMapTab1D’: src/fitschan.c:18972:44: warning: ‘__builtin___sprintf_chk’ may write a terminating nul past the end of the destination [-Wformat-overflow=] 18972 | sprintf( cellname, "COORDS%d(1)", iwcs + 1 ); | ^ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 11 and 21 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:19062:44: warning: ‘__builtin___sprintf_chk’ may write a terminating nul past the end of the destination [-Wformat-overflow=] 19062 | sprintf( cellname, "COORDS%d(1)", iwcs + 1 ); | ^ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 11 and 21 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c: In function ‘CnvValue.part.0.isra’: src/fitschan.c:7130:47: warning: ‘%s’ directive writing up to 80 bytes into a region of size between 0 and 80 [-Wformat-overflow=] 7130 | (void) sprintf( cnvtype_text, "%s %s", cnvtype_text0, cnvtype_text1 ); | ^~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 2 and 162 bytes into a destination of size 81 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/interval.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-interval.o src/fitschan.c: In function ‘SpectralAxes.constprop’: src/fitschan.c:29123:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 3 [-Wformat-overflow=] 29123 | sprintf( system_attr, "System(%d)", iax + 1 ); | ^~ src/fitschan.c:29123:32: note: directive argument in the range [1, 2147483647] 29123 | sprintf( system_attr, "System(%d)", iax + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 10 and 19 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:29129:36: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 29129 | sprintf( unit_attr, "Unit(%d)", iax + 1 ); | ^~ src/fitschan.c:29129:30: note: directive argument in the range [1, 2147483647] 29129 | sprintf( unit_attr, "Unit(%d)", iax + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 8 and 17 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/intramap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-intramap.o src/fitschan.c: In function ‘ConcatWAT.constprop’: src/fitschan.c:7411:26: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] 7411 | sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); | ^~ src/fitschan.c:7411:22: note: directive argument in the range [-2147483647, 2147483647] 7411 | sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 19 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:7431:32: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] 7431 | sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); | ^~ src/fitschan.c:7431:28: note: directive argument in the range [-2147483647, 2147483647] 7431 | sprintf( keyname, "WAT%d_%.3d", iaxis + 1, j ); | ^~~~~~~~~~~~ src/fitschan.c:7431:28: note: directive argument in the range [2, 2147483647] In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 26 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/loader.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-loader.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/fitschan.c: In function ‘CLASSFromStore.constprop’: src/fitschan.c:5888:44: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size 10 [-Wformat-overflow=] 5888 | sprintf( attbuf, "IsLonAxis(%d)", i + 1 ); | ^~ src/fitschan.c:5888:33: note: directive argument in the range [-2147483647, 3] 5888 | sprintf( attbuf, "IsLonAxis(%d)", i + 1 ); | ^~~~~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 13 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/fitschan.c: In function ‘PCFromStore.constprop’: src/fitschan.c:23790:43: warning: ‘%.3d’ directive writing between 3 and 10 bytes into a region of size 8 [-Wformat-overflow=] 23790 | sprintf( keyname, "PC%.3d%.3d", i + 1, j + 1 ); | ^~~~ src/fitschan.c:23790:40: note: directive argument in the range [1, 2147483647] 23790 | sprintf( keyname, "PC%.3d%.3d", i + 1, j + 1 ); | ^~~~~~~~~~~~ src/fitschan.c:23790:40: note: directive argument in the range [1, 2147483647] In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 23 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23835:38: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] 23835 | sprintf( keyname, "C%dELT%d", is, i + 1 ); | ^~ src/fitschan.c:23835:31: note: directive argument in the range [1, 2147483647] 23835 | sprintf( keyname, "C%dELT%d", is, i + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23833:37: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 23833 | sprintf( keyname, "CDELT%d", i + 1 ); | ^~ src/fitschan.c:23833:31: note: directive argument in the range [1, 2147483647] 23833 | sprintf( keyname, "CDELT%d", i + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23852:38: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] 23852 | sprintf( keyname, "C%dPIX%d", is, j + 1 ); | ^~ src/fitschan.c:23852:31: note: directive argument in the range [1, 2147483647] 23852 | sprintf( keyname, "C%dPIX%d", is, j + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23850:37: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 23850 | sprintf( keyname, "CRPIX%d", j + 1 ); | ^~ src/fitschan.c:23850:31: note: directive argument in the range [1, 2147483647] 23850 | sprintf( keyname, "CRPIX%d", j + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23869:38: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] 23869 | sprintf( keyname, "C%dVAL%d", is, i + 1 ); | ^~ src/fitschan.c:23869:31: note: directive argument in the range [1, 2147483647] 23869 | sprintf( keyname, "C%dVAL%d", is, i + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23867:37: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 23867 | sprintf( keyname, "CRVAL%d", i + 1 ); | ^~ src/fitschan.c:23867:31: note: directive argument in the range [1, 2147483647] 23867 | sprintf( keyname, "CRVAL%d", i + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23891:38: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] 23891 | sprintf( keyname, "C%dYPE%d", is, i + 1 ); | ^~ src/fitschan.c:23891:31: note: directive argument in the range [1, 2147483647] 23891 | sprintf( keyname, "C%dYPE%d", is, i + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23889:37: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 23889 | sprintf( keyname, "CTYPE%d", i + 1 ); | ^~ src/fitschan.c:23889:31: note: directive argument in the range [1, 2147483647] 23889 | sprintf( keyname, "CTYPE%d", i + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23934:41: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 3 and 5 [-Wformat-overflow=] 23934 | sprintf( keyname, "C%dNIT%d", is, i + 1 ); | ^~ src/fitschan.c:23934:34: note: directive argument in the range [1, 2147483647] 23934 | sprintf( keyname, "C%dNIT%d", is, i + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:23932:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 23932 | sprintf( keyname, "CUNIT%d", i + 1 ); | ^~ src/fitschan.c:23932:34: note: directive argument in the range [1, 2147483647] 23932 | sprintf( keyname, "CUNIT%d", i + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 16 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mapping.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mapping.o src/fitschan.c: In function ‘SkySys.part.0.constprop.isra’: src/fitschan.c:28782:40: warning: ‘__builtin___sprintf_chk’ may write a terminating nul past the end of the destination [-Wformat-overflow=] 28782 | sprintf( attr, "SkyRefP(%d)", axlon + 1 ); | ^ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 11 and 21 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:28784:40: warning: ‘__builtin___sprintf_chk’ may write a terminating nul past the end of the destination [-Wformat-overflow=] 28784 | sprintf( attr, "SkyRefP(%d)", axlat + 1 ); | ^ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 11 and 21 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mathmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mathmap.o src/keymap.c: In function ‘Dump’: src/keymap.c:2715:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2715 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2715:35: note: directive argument in the range [1, 2147483647] 2715 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2700:43: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2700 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2700:38: note: directive argument in the range [1, 2147483647] 2700 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2683:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2683 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2683:35: note: directive argument in the range [1, 2147483647] 2683 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2669:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2669 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2669:35: note: directive argument in the range [1, 2147483647] 2669 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2655:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2655 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2655:35: note: directive argument in the range [1, 2147483647] 2655 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2746:43: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2746 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2746:38: note: directive argument in the range [1, 2147483647] 2746 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/keymap.c:2729:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 8 and 17 [-Wformat-overflow=] 2729 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~ src/keymap.c:2729:35: note: directive argument in the range [1, 2147483647] 2729 | (void) sprintf( buff, "V%d_%d", nentry, index + 1 ); | ^~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/keymap.c:236: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 5 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c: In function ‘WcsMapFrm.constprop’: src/fitschan.c:37644:37: warning: ‘%s’ directive writing up to 99 bytes into a region of size between 0 and 100 [-Wformat-overflow=] 37644 | sprintf( buf, "%s-%s", newdom, buf2 ); | ^~ ~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 2 and 201 bytes into a destination of size 101 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/fitschan.c: In function ‘SpecTrans.constprop’: src/fitschan.c:30075:44: warning: ‘%.3d’ directive writing between 3 and 10 bytes into a region of size between 1 and 8 [-Wformat-overflow=] 30075 | sprintf( keyname, "CD%.3d%.3d", j + 1, i + 1 ); | ^~~~ src/fitschan.c:30075:37: note: directive argument in the range [1, 2147483647] 30075 | sprintf( keyname, "CD%.3d%.3d", j + 1, i + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 23 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30177:47: warning: ‘%.3d’ directive writing between 3 and 10 bytes into a region of size between 1 and 8 [-Wformat-overflow=] 30177 | sprintf( keyname, "PC%.3d%.3d", j + 1, i + 1 ); | ^~~~ src/fitschan.c:30177:40: note: directive argument in the range [1, 2147483647] 30177 | sprintf( keyname, "PC%.3d%.3d", j + 1, i + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 23 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30389:44: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 0 and 8 [-Wformat-overflow=] 30389 | sprintf( keyname, "C%dELT%d", m, j + 1 ); | ^~ src/fitschan.c:30389:37: note: directive argument in the range [1, 2147483647] 30389 | sprintf( keyname, "C%dELT%d", m, j + 1 ); | ^~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 26 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30409:43: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] 30409 | sprintf( keyname, "CDELT%d%c", j + 1, ss ); | ^~ src/fitschan.c:30409:37: note: directive argument in the range [1, 2147483647] 30409 | sprintf( keyname, "CDELT%d%c", j + 1, ss ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 8 and 17 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30417:47: warning: ‘%.3d’ directive writing between 3 and 10 bytes into a region of size between 1 and 8 [-Wformat-overflow=] 30417 | sprintf( keyname, "PC%.3d%.3d", j + 1, i + 1 ); | ^~~~ src/fitschan.c:30417:40: note: directive argument in the range [1, 2147483647] 30417 | sprintf( keyname, "PC%.3d%.3d", j + 1, i + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 23 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30611:34: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size 8 [-Wformat-overflow=] 30611 | sprintf( keyname, "CRVAL%d", axlon + 1 ); | ^~ src/fitschan.c:30611:28: note: directive argument in the range [-2147483647, 2147483647] 30611 | sprintf( keyname, "CRVAL%d", axlon + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 17 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:30616:34: warning: ‘%d’ directive writing between 1 and 11 bytes into a region of size 8 [-Wformat-overflow=] 30616 | sprintf( keyname, "CRVAL%d", axlat + 1 ); | ^~ src/fitschan.c:30616:28: note: directive argument in the range [-2147483647, 2147483647] 30616 | sprintf( keyname, "CRVAL%d", axlat + 1 ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 17 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13277:41: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13277 | sprintf( template, "PV%d_%d", latax, m ); | ^~ src/fitschan.c:13277:35: note: directive argument in the range [1, 2147483647] 13277 | sprintf( template, "PV%d_%d", latax, m ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 6 and 25 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13275:41: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13275 | sprintf( template, "PV%d_%d%c", latax, m, s ); | ^~ src/fitschan.c:13275:35: note: directive argument in the range [1, 2147483647] 13275 | sprintf( template, "PV%d_%d%c", latax, m, s ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 26 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13323:44: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13323 | sprintf( template, "PV%d_%d", lonax, m ); | ^~ src/fitschan.c:13323:38: note: directive argument in the range [1, 2147483647] 13323 | sprintf( template, "PV%d_%d", lonax, m ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 6 and 25 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13321:44: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13321 | sprintf( template, "PV%d_%d%c", lonax, m, s ); | ^~ src/fitschan.c:13321:38: note: directive argument in the range [1, 2147483647] 13321 | sprintf( template, "PV%d_%d%c", lonax, m, s ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 26 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13346:47: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13346 | sprintf( template, "PV%d_%d", lonax, m ); | ^~ src/fitschan.c:13346:41: note: directive argument in the range [1, 2147483647] 13346 | sprintf( template, "PV%d_%d", lonax, m ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 6 and 25 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13344:47: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13344 | sprintf( template, "PV%d_%d%c", lonax, m, s ); | ^~ src/fitschan.c:13344:41: note: directive argument in the range [1, 2147483647] 13344 | sprintf( template, "PV%d_%d%c", lonax, m, s ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 26 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13307:44: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13307 | sprintf( template, "PV%d_%d", latax, m ); | ^~ src/fitschan.c:13307:38: note: directive argument in the range [1, 2147483647] 13307 | sprintf( template, "PV%d_%d", latax, m ); | ^~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 6 and 25 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:13305:44: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size between 6 and 16 [-Wformat-overflow=] 13305 | sprintf( template, "PV%d_%d%c", latax, m, s ); | ^~ src/fitschan.c:13305:38: note: directive argument in the range [1, 2147483647] 13305 | sprintf( template, "PV%d_%d%c", latax, m, s ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 7 and 26 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/fitschan.c: In function ‘AddVersion.constprop’: src/fitschan.c:20655:46: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 20655 | sprintf( system_attr, "System(%d)", ilon + 1 ); | ^~ src/fitschan.c:20655:38: note: directive argument in the range [0, 2147483647] 20655 | sprintf( system_attr, "System(%d)", ilon + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 10 and 19 bytes into a destination of size 12 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:20662:48: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 5 [-Wformat-overflow=] 20662 | sprintf( equinox_attr, "Equinox(%d)", ilon + 1 ); | ^~ src/fitschan.c:20662:39: note: directive argument in the range [0, 2147483647] 20662 | sprintf( equinox_attr, "Equinox(%d)", ilon + 1 ); | ^~~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 11 and 20 bytes into a destination of size 13 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:10459:38: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] 10459 | sprintf( attr_name, "Symbol(%d)", i + 1 ); | ^~ src/fitschan.c:10459:30: note: directive argument in the range [1, 2147483647] 10459 | sprintf( attr_name, "Symbol(%d)", i + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 10 and 19 bytes into a destination of size 15 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c:10496:41: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 8 [-Wformat-overflow=] 10496 | sprintf( attr_name, "Symbol(%d)", i + 1 ); | ^~ src/fitschan.c:10496:33: note: directive argument in the range [1, 2147483647] 10496 | sprintf( attr_name, "Symbol(%d)", i + 1 ); | ^~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 10 and 19 bytes into a destination of size 15 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ src/fitschan.c: In function ‘Read’: src/fitschan.c:11254:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 11254 | sprintf( buff, "Pixel axis %d", i + 1 ); | ^~ src/fitschan.c:11254:28: note: directive argument in the range [1, 2147483647] 11254 | sprintf( buff, "Pixel axis %d", i + 1 ); | ^~~~~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/fitschan.c:1406: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 13 and 22 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/memory.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-memory.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/memory.c: In function ‘ChrMatcher’: src/memory.c:3383:40: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 6 [-Wformat-overflow=] 3383 | sprintf( stemp, ".*($%d).*", dollar ); | ^~ src/memory.c:3383:35: note: directive argument in the range [1, 2147483647] 3383 | sprintf( stemp, ".*($%d).*", dollar ); | ^~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/memory.c:215: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 9 and 18 bytes into a destination of size 10 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/moc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-moc.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/mocchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-mocchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/normmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-normmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/nullregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-nullregion.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/object.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-object.o In file included from src/object.h:342, from src/channel.h:220, from src/moc.c:198: src/moc.c: In function ‘astAddMocText_’: src/error.h:338:18: warning: ‘%.30s’ directive argument is null [-Wformat-overflow=] 338 | #define astError astError_ src/moc.c:1523:16: note: in expansion of macro ‘astError’ 1523 | astError( AST__INMOC, "%s(%s): Invalid string MOC supplied: '%.30s...'", | ^~~~~~~~ src/error.h:338:18: warning: ‘%.30s’ directive argument is null [-Wformat-overflow=] 338 | #define astError astError_ src/moc.c:1513:16: note: in expansion of macro ‘astError’ 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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-plot.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/plot3d.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-plot3d.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointlist.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-pointlist.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/pointset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-pointset.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/prism.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-prism.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ratemap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ratemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/shiftmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-shiftmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/skyaxis.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-skyaxis.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specfluxframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specfluxframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specframe.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/specmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-specmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/sphmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-sphmap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stccatalogentrylocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stccatalogentrylocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcobsdatalocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcobsdatalocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcresourceprofile.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcresourceprofile.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcschan.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/stcsearchlocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-stcsearchlocation.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/table.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-table.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/timeframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-timeframe.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unit.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-unit.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/unitnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-unitnormmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/wcsmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-wcsmap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/winmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-winmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xmlchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-xmlchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 src/xmlchan.c: In function ‘StcMetadataReader’: src/xmlchan.c:7811:48: warning: ‘%d’ directive writing between 1 and 10 bytes into a region of size 9 [-Wformat-overflow=] 7811 | sprintf( orgatt, "TimeOrigin(%d)", i + 1 ); | ^~ src/xmlchan.c:7811:36: note: directive argument in the range [1, 2147483647] 7811 | sprintf( orgatt, "TimeOrigin(%d)", i + 1 ); | ^~~~~~~~~~~~~~~~ In file included from /usr/include/stdio.h:867, from src/object.h:350, from src/channel.h:220, from src/yamlchan.h:61, from src/globals.h:11, from src/xmlchan.c:210: /usr/include/x86_64-linux-gnu/bits/stdio2.h:36:10: note: ‘__builtin___sprintf_chk’ output between 14 and 23 bytes into a destination of size 20 36 | return __builtin___sprintf_chk (__s, __USE_FORTIFY_LEVEL - 1, | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 37 | __bos (__s), __fmt, __va_arg_pack ()); | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/xphmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-xphmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fyamlchan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fyamlchan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/c2f77.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-c2f77.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fchannel.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fchannel.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fcmpmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fcmpmap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fellipse.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fellipse.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffitschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ffitschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ffluxframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ffluxframe.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fframeset.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fframeset.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fgrismmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fgrismmap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fintramap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fintramap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fmatrixmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fmatrixmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fnormmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fnullregion.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fnullregion.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fplot.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fplot.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fpolygon.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fpolygon.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fprism.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fprism.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fspecframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fspecframe.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstc.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstc.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcobsdatalocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcobsdatalocation.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcschan.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcschan.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fstcsearchlocation.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fstcsearchlocation.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fswitchmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fswitchmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftable.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ftable.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimeframe.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ftimeframe.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/ftimemap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-ftimemap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/funitnormmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-funitnormmap.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fwcsmap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fwcsmap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c src/fzoommap.c -fPIC -DPIC -o src/.libs/libstarlink_ast_la-fzoommap.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/proj.c -fPIC -DPIC -o wcslib/.libs/libstarlink_ast_la-proj.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/tpn.c -fPIC -DPIC -o wcslib/.libs/libstarlink_ast_la-tpn.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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -c wcslib/wcstrig.c -fPIC -DPIC -o wcslib/.libs/libstarlink_ast_la-wcstrig.o libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -DTHREAD_SAFE -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 libtool: compile: gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 /bin/bash ./libtool --tag=CC --mode=link gcc -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o astbad src/astbad.o -lpthread libtool: link: gcc -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -o astbad src/astbad.o -lpthread /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_err.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_err_la-err_null.lo -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,-soname -Wl,libstarlink_ast_err.so.9 -o .libs/libstarlink_ast_err.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so.9" && ln -s "libstarlink_ast_err.so.9.2.3" "libstarlink_ast_err.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_err.so" && ln -s "libstarlink_ast_err.so.9.2.3" "libstarlink_ast_err.so") libtool: link: ar cr .libs/libstarlink_ast_err.a src/libstarlink_ast_err_la-err_null.o libtool: link: ranlib .libs/libstarlink_ast_err.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_err.la" && ln -s "../libstarlink_ast_err.la" "libstarlink_ast_err.la" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_grf3d.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_grf3d_la-grf3d.lo -lpthread 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,-soname -Wl,libstarlink_ast_grf3d.so.9 -o .libs/libstarlink_ast_grf3d.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so.9" && ln -s "libstarlink_ast_grf3d.so.9.2.3" "libstarlink_ast_grf3d.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf3d.so" && ln -s "libstarlink_ast_grf3d.so.9.2.3" "libstarlink_ast_grf3d.so") libtool: link: ar cr .libs/libstarlink_ast_grf3d.a src/libstarlink_ast_grf3d_la-grf3d.o libtool: link: ranlib .libs/libstarlink_ast_grf3d.a libtool: link: ( cd ".libs" && rm -f "libstarlink_ast_grf3d.la" && ln -s "../libstarlink_ast_grf3d.la" "libstarlink_ast_grf3d.la" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_grf_2.0.la -rpath /usr/lib/x86_64-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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_grf_3.2.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_grf_3_2_la-grf_3.2.lo -lpthread 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,-soname -Wl,libstarlink_ast_grf_2.0.so.9 -o .libs/libstarlink_ast_grf_2.0.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so.9" && ln -s "libstarlink_ast_grf_2.0.so.9.2.3" "libstarlink_ast_grf_2.0.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_2.0.so" && ln -s "libstarlink_ast_grf_2.0.so.9.2.3" "libstarlink_ast_grf_2.0.so") libtool: link: ar cr .libs/libstarlink_ast_grf_2.0.a src/libstarlink_ast_grf_2_0_la-grf_2.0.o libtool: link: ranlib .libs/libstarlink_ast_grf_2.0.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" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_grf_5.6.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_grf_5_6_la-grf_5.6.lo -lpthread 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,-soname -Wl,libstarlink_ast_grf_3.2.so.9 -o .libs/libstarlink_ast_grf_3.2.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so.9" && ln -s "libstarlink_ast_grf_3.2.so.9.2.3" "libstarlink_ast_grf_3.2.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_3.2.so" && ln -s "libstarlink_ast_grf_3.2.so.9.2.3" "libstarlink_ast_grf_3.2.so") 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_3.2.la" && ln -s "../libstarlink_ast_grf_3.2.la" "libstarlink_ast_grf_3.2.la" ) /bin/bash ./libtool --tag=CC --mode=link gcc -prefer-pic -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_pgplot.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_pgplot_la-grf_pgplot.lo -lpthread 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,-soname -Wl,libstarlink_ast_grf_5.6.so.9 -o .libs/libstarlink_ast_grf_5.6.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_grf_5.6.so.9" && ln -s "libstarlink_ast_grf_5.6.so.9.2.3" "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.3" "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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast_pgplot3d.la -rpath /usr/lib/x86_64-linux-gnu src/libstarlink_ast_pgplot3d_la-grf3d_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,-soname -Wl,libstarlink_ast_pgplot.so.9 -o .libs/libstarlink_ast_pgplot.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so.9" && ln -s "libstarlink_ast_pgplot.so.9.2.3" "libstarlink_ast_pgplot.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot.so" && ln -s "libstarlink_ast_pgplot.so.9.2.3" "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: link: ( cd ".libs" && rm -f "libstarlink_ast_pgplot.la" && ln -s "../libstarlink_ast_pgplot.la" "libstarlink_ast_pgplot.la" ) 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,-soname -Wl,libstarlink_ast_pgplot3d.so.9 -o .libs/libstarlink_ast_pgplot3d.so.9.2.3 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: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so.9" && ln -s "libstarlink_ast_pgplot3d.so.9.2.3" "libstarlink_ast_pgplot3d.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast_pgplot3d.so" && ln -s "libstarlink_ast_pgplot3d.so.9.2.3" "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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -version-info 11:3:2 -Wl,-z,relro -o libstarlink_ast.la -rpath /usr/lib/x86_64-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 -lm -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 -lm -lpthread -g -O2 -fstack-protector-strong -Wl,-z -Wl,relro -Wl,-soname -Wl,libstarlink_ast.so.9 -o .libs/libstarlink_ast.so.9.2.3 libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so.9" && ln -s "libstarlink_ast.so.9.2.3" "libstarlink_ast.so.9") libtool: link: (cd ".libs" && rm -f "libstarlink_ast.so" && ln -s "libstarlink_ast.so.9.2.3" "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/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_auto_test -i make -j4 check VERBOSE=1 make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make check-am make[2]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make ast_test make[3]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' gcc -DHAVE_CONFIG_H -I. -Wdate-time -D_FORTIFY_SOURCE=2 -I/usr/include/star -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z,relro -o ast_test ast_test.o -lstarlink_pal libstarlink_ast.la libstarlink_ast_grf_3.2.la libstarlink_ast_grf_5.6.la libstarlink_ast_grf_2.0.la libstarlink_ast_grf3d.la libstarlink_ast_err.la -lm -lpthread libtool: link: gcc -g -O2 -fdebug-prefix-map=/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg=. -fstack-protector-strong -Wformat -Werror=format-security -Wl,-z -Wl,relro -o .libs/ast_test ast_test.o -lstarlink_pal ./.libs/libstarlink_ast.so ./.libs/libstarlink_ast_grf_3.2.so ./.libs/libstarlink_ast_grf_5.6.so ./.libs/libstarlink_ast_grf_2.0.so ./.libs/libstarlink_ast_grf3d.so ./.libs/libstarlink_ast_err.so -lm -lpthread make[3]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make check-TESTS make[3]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[4]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' PASS: ast_test ============================================================================ Testsuite summary for ast 9.2.3 ============================================================================ # TOTAL: 1 # PASS: 1 # SKIP: 0 # XFAIL: 0 # FAIL: 0 # XPASS: 0 # ERROR: 0 ============================================================================ make[4]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[3]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[2]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' create-stamp debian/debhelper-build-stamp dh_testroot -i dh_prep -i dh_auto_install -i make -j1 install DESTDIR=/build/starlink-ast-EXokvp/starlink-ast-9.2.3\+dfsg/debian/tmp AM_UPDATE_INFO_DIR=no make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make install-am make[2]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[3]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/bin' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/bin' /usr/bin/install -c ast_link_adam '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/bin' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-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/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu' libtool: install: /usr/bin/install -c .libs/libstarlink_ast.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast.so.9.2.3 libstarlink_ast.so.9 || { rm -f libstarlink_ast.so.9 && ln -s libstarlink_ast.so.9.2.3 libstarlink_ast.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast.so.9.2.3 libstarlink_ast.so || { rm -f libstarlink_ast.so && ln -s libstarlink_ast.so.9.2.3 libstarlink_ast.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_err.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_err.so.9.2.3 libstarlink_ast_err.so.9 || { rm -f libstarlink_ast_err.so.9 && ln -s libstarlink_ast_err.so.9.2.3 libstarlink_ast_err.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_err.so.9.2.3 libstarlink_ast_err.so || { rm -f libstarlink_ast_err.so && ln -s libstarlink_ast_err.so.9.2.3 libstarlink_ast_err.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_err.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.9.2.3 libstarlink_ast_grf3d.so.9 || { rm -f libstarlink_ast_grf3d.so.9 && ln -s libstarlink_ast_grf3d.so.9.2.3 libstarlink_ast_grf3d.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf3d.so.9.2.3 libstarlink_ast_grf3d.so || { rm -f libstarlink_ast_grf3d.so && ln -s libstarlink_ast_grf3d.so.9.2.3 libstarlink_ast_grf3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.9.2.3 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.3 libstarlink_ast_grf_2.0.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_2.0.so.9.2.3 libstarlink_ast_grf_2.0.so || { rm -f libstarlink_ast_grf_2.0.so && ln -s libstarlink_ast_grf_2.0.so.9.2.3 libstarlink_ast_grf_2.0.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.9.2.3 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.3 libstarlink_ast_grf_3.2.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_3.2.so.9.2.3 libstarlink_ast_grf_3.2.so || { rm -f libstarlink_ast_grf_3.2.so && ln -s libstarlink_ast_grf_3.2.so.9.2.3 libstarlink_ast_grf_3.2.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.9.2.3 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.3 libstarlink_ast_grf_5.6.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_grf_5.6.so.9.2.3 libstarlink_ast_grf_5.6.so || { rm -f libstarlink_ast_grf_5.6.so && ln -s libstarlink_ast_grf_5.6.so.9.2.3 libstarlink_ast_grf_5.6.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.9.2.3 libstarlink_ast_pgplot.so.9 || { rm -f libstarlink_ast_pgplot.so.9 && ln -s libstarlink_ast_pgplot.so.9.2.3 libstarlink_ast_pgplot.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_pgplot.so.9.2.3 libstarlink_ast_pgplot.so || { rm -f libstarlink_ast_pgplot.so && ln -s libstarlink_ast_pgplot.so.9.2.3 libstarlink_ast_pgplot.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.so.9.2.3 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.so.9.2.3 libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.9.2.3 libstarlink_ast_pgplot3d.so.9 || { rm -f libstarlink_ast_pgplot3d.so.9 && ln -s libstarlink_ast_pgplot3d.so.9.2.3 libstarlink_ast_pgplot3d.so.9; }; }) libtool: install: (cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu && { ln -s -f libstarlink_ast_pgplot3d.so.9.2.3 libstarlink_ast_pgplot3d.so || { rm -f libstarlink_ast_pgplot3d.so && ln -s libstarlink_ast_pgplot3d.so.9.2.3 libstarlink_ast_pgplot3d.so; }; }) libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.lai /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.la libtool: install: /usr/bin/install -c .libs/libstarlink_ast.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_err.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_err.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_err.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_err.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf3d.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_2.0.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_3.2.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_grf_5.6.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.a libtool: install: /usr/bin/install -c .libs/libstarlink_ast_pgplot3d.a /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: chmod 644 /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: install: ranlib /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.a libtool: warning: remember to run 'libtool --finish /usr/lib/x86_64-linux-gnu' make install-exec-hook make[4]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' /bin/mkdir -p /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu cd /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu; \ for f in `ls libstarlink_ast.*`; do \ ff=`echo $f | sed -e 's/libstarlink_ast/libstarlink_ast_pass2/'`; \ if test -f "$ff"; then rm "$ff"; fi; \ ln -s $f $ff; \ /bin/true && echo "MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/$ff" || :; \ done; \ if test -f "libstarlink_ast.la"; then \ if test -f "libstarlink_ast_pass2.la"; then rm "libstarlink_ast_pass2.la"; fi; \ sed -e 's/libstarlink_ast\./libstarlink_ast_pass2\./g' libstarlink_ast.la > libstarlink_ast_pass2.la; \ fi MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.a MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.la MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.so MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.so.9 MANIFEST:/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.so.9.2.3 make[4]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include/star' /usr/bin/install -c -m 644 GRF_PAR src/grf.h src/grf3d.h '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include/star' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 GRF_PAR src/grf.h src/grf3d.h '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include/star' /usr/bin/install -c -m 644 ast.h AST_PAR '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include/star' /bin/mkdir -p '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include' /usr/bin/install -c -m 644 ast.h AST_PAR '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/debian/tmp/usr/include' make[3]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[2]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make[1]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_install -i debian/rules override_dh_installdocs-indep make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' make doc make[2]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' pdflatex sun211.tex && pdflatex sun211.tex This is pdfTeX, Version 3.14159265-2.6-1.40.21 (TeX Live 2020/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2020-02-02> patch level 5 L3 programming layer <2020-09-24> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2019/12/20 v1.4l 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/microtype/microtype-pdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/mathpazo.sty) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse-generic.tex)) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/multirow/multirow.sty) (/usr/share/texlive/texmf-dist/tex/latex/enumitem/enumitem.sty) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/dvipsnam.def) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/svgnam.def)) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvsetkeys/kvsetkeys.sty)) (/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty) (/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/infwarerr/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.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/generic/atbegshi/atbegshi.sty)) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/frontendlayer/tikz.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgf.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfrcs.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common-lists.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-latex.def (/usr/share/texlive/texmf-dist/tex/latex/ms/everyshi.sty)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfrcs.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/pgf.revision.tex))) (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgfcore.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/systemlayer/pgfsys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeysfiltered.code.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgf.cfg) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-pdftex.def (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-common-pdf.de f))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsyssoftpath.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsysprotocol.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcore.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathcalc.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathutil.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathparser.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.basic.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.trigonomet ric.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.random.cod e.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.comparison .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.base.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.round.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.misc.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.integerari thmetics.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/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/math/pgfmath.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/tikz.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/libraries/pgflibraryplothandlers .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmodulematrix.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/libraries/tik zlibrarytopaths.code.tex))) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/md-frame-1.mdf)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/rotating.sty (/usr/share/texlive/texmf-dist/tex/latex/base/ifthen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/pdflscape/pdflscape.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/letltxmacro/letltxmacro.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/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/latex/atveryend/atveryend.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/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/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)) No file sun211.aux. (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator-basic-dictionary -English.dict) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx-abbreviations.cfg) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) ABD: EveryShipout initializing macros *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omlzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omszplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omxzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1zplm.fd) Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map} <./sun211_figures/fronta. pdf> <./sun211_figures/frontb.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontb.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page > <./sun211_figures/frontc.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontc.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page >] [2] [3] [4] [1] LaTeX Warning: Hyper reference `System' on page 2 undefined on input line 146. (/usr/share/texlive/texmf-dist/tex/latex/base/t1cmtt.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/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.86678pt too wide) in paragraph at lines 316--318 []\T1/ppl/m/n/10.95 (-20) Various lin-ear co-or-di-nate trans-for-ma-tions (the Ma-trixMap, Win-Map, ShiftMap and ZoomMap). LaTeX Warning: Hyper reference `PolyMap' on page 6 undefined on input line 319. LaTeX Warning: Hyper reference `ChebyMap' on page 6 undefined on input line 320 . LaTeX Warning: Hyper reference `LutMap' on page 6 undefined on input line 322. LaTeX Warning: Hyper reference `MathMap' on page 6 undefined on input line 326. LaTeX Warning: Hyper reference `IntraMap' on page 6 undefined on input line 330 . LaTeX Warning: Reference `ss:classdescriptions' on page 6 undefined on input li ne 335. LaTeX Warning: Reference `ss:permmapexample' on page 6 undefined on input line 336. LaTeX Warning: Hyper reference `UnitMap' on page 6 undefined on input line 336. LaTeX Warning: Reference `ss:unitmapexample' on page 6 undefined on input line 337. LaTeX Warning: Reference `ss:intramaps' on page 6 undefined on input line 338. LaTeX Warning: Reference `ss:primer' on page 6 undefined on input line 339. LaTeX Warning: Reference `ss:mappingselection' on page 6 undefined on input lin e 343. LaTeX Warning: Hyper reference `Mapping' on page 6 undefined on input line 345. LaTeX Warning: Hyper reference `CmpMap' on page 6 undefined on input line 346. LaTeX Warning: Reference `fig:seriescmpmap' on page 6 undefined on input line 3 53. LaTeX Warning: Reference `fig:parallelcmpmap' on page 6 undefined on input line 369. LaTeX Warning: Hyper reference `TranMap' on page 6 undefined on input line 384. LaTeX Warning: Reference `fig:complexcmpmap' on page 6 undefined on input line 389. LaTeX Warning: Reference `ss:cmpmaps' on page 6 undefined on input line 406. LaTeX Warning: Reference `ss:classdescriptions' on page 6 undefined on input li ne 407. [6] [7 <./sun211_figures/series.pdf> <./sun211_figures/parallel.pdf>] LaTeX Warning: Reference `ss:mappingoverview' on page 8 undefined on input line 411. LaTeX Warning: Reference `fig:frames' on page 8 undefined on input line 414. LaTeX Warning: Hyper reference `SkyFrame' on page 8 undefined on input line 421 . LaTeX Warning: Hyper reference `Frame' on page 8 undefined on input line 421. LaTeX Warning: Hyper reference `SkyFrame' on page 8 undefined on input line 421 . LaTeX Warning: Hyper reference `Frame' on page 8 undefined on input line 421. LaTeX Warning: Reference `fig:frames' on page 8 undefined on input line 446. LaTeX Warning: Hyper reference `SpecFrame' on page 8 undefined on input line 44 7. LaTeX Warning: Hyper reference `TimeFrame' on page 8 undefined on input line 44 7. LaTeX Warning: Reference `ss:cmpmapoverview' on page 8 undefined on input line 452. LaTeX Warning: Hyper reference `CmpFrame' on page 8 undefined on input line 453 . LaTeX Warning: Reference `fig:cmpframe' on page 8 undefined on input line 456. LaTeX Warning: Reference `fig:complexcmpmap' on page 8 undefined on input line 468. LaTeX Warning: Reference `fig:complexcmpmap' on page 8 undefined on input line 468. [8 <./sun211_figures/complex.pdf>] LaTeX Warning: Reference `ss:frames' on page 9 undefined on input line 474. LaTeX Warning: Reference `ss:skyframes' on page 9 undefined on input line 474. LaTeX Warning: Reference `ss:specframes' on page 9 undefined on input line 475. LaTeX Warning: Reference `ss:classdescriptions' on page 9 undefined on input li ne 476. LaTeX Warning: Reference `fig:frameset' on page 9 undefined on input line 482. LaTeX Warning: Hyper reference `FrameSet' on page 9 undefined on input line 494 . LaTeX Warning: Hyper reference `Frame' on page 9 undefined on input line 494. LaTeX Warning: Hyper reference `Mapping' on page 9 undefined on input line 495. LaTeX Warning: Reference `ss:framesets' on page 9 undefined on input line 516. LaTeX Warning: Reference `ss:fshigher' on page 9 undefined on input line 516. LaTeX Warning: Reference `ss:classdescriptions' on page 9 undefined on input li ne 517. [9 <./sun211_figures/frames.pdf>] LaTeX Warning: Hyper reference `Object' on page 10 undefined on input line 521. LaTeX Warning: Hyper reference `Channel' on page 10 undefined on input line 527 . LaTeX Warning: Hyper reference `FitsChan' on page 10 undefined on input line 54 1. LaTeX Warning: Hyper reference `XmlChan' on page 10 undefined on input line 547 . LaTeX Warning: Hyper reference `Stc' on page 10 undefined on input line 559. [10 <./sun211_figures/cmpframe.pdf>] [11 <./sun211_figures/frameset.pdf>] LaTeX Warning: Hyper reference `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.34566pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.36206pt 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.36206pt 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.36206pt 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.36206pt 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.36206pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.86975pt 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 (16.11847pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.86975pt 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 34. LaTeX Warning: Hyper reference `MeshSize' on page 313 undefined on input line 1 8434. Overfull \hbox (12.97206pt too wide) in paragraph at lines 18434--18434 []\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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 34. LaTeX Warning: Hyper reference `Box' on page 313 undefined on input line 18434. Overfull \hbox (16.11847pt too wide) in paragraph at lines 18434--18434 [][]\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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [313] LaTeX Warning: Hyper reference `Region' on page 314 undefined on input line 185 83. Overfull \hbox (32.0758pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583. LaTeX Warning: Hyper reference `Circle' on page 314 undefined on input line 185 83. Overfull \hbox (2.26344pt too wide) in paragraph at lines 18583--18583 \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 18583. LaTeX Warning: Hyper reference `astDecompose' on page 314 undefined on input li ne 18583. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 583. Overfull \hbox (7.51216pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 8583. Overfull \hbox (44.25319pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18583--18583 \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 18583. Overfull \hbox (24.83293pt too wide) in paragraph at lines 18583--18583 \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 583. Overfull \hbox (7.51216pt too wide) in paragraph at lines 18583--18583 \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 3. Overfull \hbox (30.55527pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 18583--18583 [][]\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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18638. LaTeX Warning: Hyper reference `KeyMap' on page 316 undefined on input line 186 38. LaTeX Warning: Hyper reference `System' on page 316 undefined on input line 186 38. Overfull \hbox (0.10988pt too wide) in paragraph at lines 18638--18638 \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 18638--18638 \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 18638--18638 LaTeX Warning: Hyper reference `Object' on page 316 undefined on input line 186 38. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18638--18638 [][]\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 18674. Overfull \hbox (13.49411pt too wide) in paragraph at lines 18674--18674 [][]\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 11. LaTeX Warning: Hyper reference `Stc' on page 318 undefined on input line 18711. LaTeX Warning: Hyper reference `Object' on page 318 undefined on input line 187 11. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18711--18711 [][]\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 8754. LaTeX Warning: Hyper reference `FitsTable' on page 319 undefined on input line 18754. LaTeX Warning: Hyper reference `astAnnul' on page 319 undefined on input line 1 8754. Overfull \hbox (28.19052pt too wide) in paragraph at lines 18754--18754 [][]\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 18754. Overfull \hbox (33.43924pt too wide) in paragraph at lines 18754--18754 [][]\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 18754--18754 \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 8810. LaTeX Warning: Hyper reference `KeyMap' on page 320 undefined on input line 188 10. LaTeX Warning: Hyper reference `FitsTable' on page 320 undefined on input line 18810. LaTeX Warning: Hyper reference `astPutTable' on page 320 undefined on input lin e 18810. LaTeX Warning: Hyper reference `astPutTables' on page 320 undefined on input li ne 18810. LaTeX Warning: Hyper reference `astWrite' on page 320 undefined on input line 1 8810. LaTeX Warning: Hyper reference `FrameSet' on page 320 undefined on input line 1 8810. LaTeX Warning: Hyper reference `TabOK' on page 320 undefined on input line 1881 0. LaTeX Warning: Hyper reference `astAnnul' on page 320 undefined on input line 1 8810. Overfull \hbox (10.13652pt too wide) in paragraph at lines 18810--18810 \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 18810--18810 \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 10. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18810--18810 [][]\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 01. LaTeX Warning: Hyper reference `astSetUnc' on page 321 undefined on input line 18901. Overfull \hbox (47.34834pt too wide) in paragraph at lines 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901. Overfull \hbox (24.83293pt too wide) in paragraph at lines 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 1. Overfull \hbox (18.0096pt too wide) in paragraph at lines 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 01. LaTeX Warning: Hyper reference `astMapRegion' on page 321 undefined on input li ne 18901. Overfull \hbox (21.36719pt too wide) in paragraph at lines 18901--18901 [][]\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 18901--18901 \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 18901--18901 \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 18901--18901 \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 01. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18901--18901 [][]\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 18938. LaTeX Warning: Hyper reference `Plot' on page 322 undefined on input line 18938 . LaTeX Warning: Hyper reference `astGrfSet' on page 322 undefined on input line 18938. Overfull \hbox (5.62103pt too wide) in paragraph at lines 18938--18938 [][]\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 18969 . LaTeX Warning: Hyper reference `astGrfPop' on page 323 undefined on input line 18969. LaTeX Warning: Hyper reference `astGrfSet' on page 323 undefined on input line 18969. [323] LaTeX Warning: Hyper reference `Plot' on page 324 undefined on input line 19440 . LaTeX Warning: Hyper reference `ast_link' on page 324 undefined on input line 1 9440. LaTeX Warning: Hyper reference `Grf' on page 324 undefined on input line 19440. Overfull \hbox (31.60219pt too wide) in paragraph at lines 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 440. Overfull \hbox (2.26344pt too wide) in paragraph at lines 19440--19440 []\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 19440--19440 \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 40. LaTeX Warning: Hyper reference `astGetGrfContext' on page 324 undefined on inpu t line 19440. Overfull \hbox (12.76088pt too wide) in paragraph at lines 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 40. Overfull \hbox (2.52588pt too wide) in paragraph at lines 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 []\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 19440--19440 []\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 19440--19440 []\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 \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 19440--19440 [][]\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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19485 . LaTeX Warning: Hyper reference `Plot3D' on page 329 undefined on input line 194 85. LaTeX Warning: Hyper reference `RootCorner' on page 329 undefined on input line 19485. Overfull \hbox (47.61078pt too wide) in paragraph at lines 19485--19485 [][]\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 19485--19485 \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 19485--19485 \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 19485--19485 \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 1948 5. Overfull \hbox (0.37231pt too wide) in paragraph at lines 19485--19485 [][]\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 19485. LaTeX Warning: Hyper reference `TranInverse' on page 329 undefined on input lin e 19485. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19485--19485 [][]\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 19485--19485 \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 19552 . LaTeX Warning: Hyper reference `astGrid' on page 330 undefined on input line 19 552. LaTeX Warning: Hyper reference `Mapping' on page 330 undefined on input line 19 552. LaTeX Warning: Hyper reference `astClip' on page 330 undefined on input line 19 552. LaTeX Warning: Hyper reference `Naxes' on page 330 undefined on input line 1955 2. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19552--19552 \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 19552--19552 \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 19552--19552 \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 19552--19552 \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 19552--19552 [][]\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 2. LaTeX Warning: Hyper reference `TranInverse' on page 330 undefined on input lin e 19552. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19552--19552 [][]\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 9619. LaTeX Warning: Hyper reference `Mapping' on page 331 undefined on input line 19 619. LaTeX Warning: Hyper reference `GrismWaveR' on page 331 undefined on input line 19619. LaTeX Warning: Hyper reference `GrismNRP' on page 331 undefined on input line 1 9619. LaTeX Warning: Hyper reference `GrismG' on page 331 undefined on input line 196 19. LaTeX Warning: Hyper reference `astSet' on page 331 undefined on input line 196 19. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19619--19619 \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 19619--19619 \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 19619--19619 \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 19619--19619 [] \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 19619--19619 \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 19619--19619 \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 19. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19619--19619 [][]\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 67. Overfull \hbox (10.60732pt too wide) in paragraph at lines 19667--19667 [][]\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 1970 4. LaTeX Warning: Hyper reference `astAddColumn' on page 333 undefined on input li ne 19704. Overfull \hbox (15.85603pt too wide) in paragraph at lines 19704--19704 \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 1. LaTeX Warning: Hyper reference `astAddParameter' on page 334 undefined on input line 19741. Overfull \hbox (31.60219pt too wide) in paragraph at lines 19741--19741 \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 71. LaTeX Warning: Hyper reference `astEnd' on page 335 undefined on input line 197 71. [335] LaTeX Warning: Hyper reference `Frame' on page 336 undefined on input line 1986 1. LaTeX Warning: Hyper reference `SkyFrame' on page 336 undefined on input line 1 9861. Overfull \hbox (28.71822pt too wide) in paragraph at lines 19861--19861 []\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 1. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \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 19861--19861 \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 19861--19861 [][]\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 19861--19861 \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 19861--19861 [][]\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 19861--19861 \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 19861. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [][]\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 1 9994. LaTeX Warning: Hyper reference `Region' on page 337 undefined on input line 199 94. LaTeX Warning: Hyper reference `Frame' on page 337 undefined on input line 1999 4. LaTeX Warning: Hyper reference `SkyFrame' on page 337 undefined on input line 1 9994. LaTeX Warning: Hyper reference `Box' on page 337 undefined on input line 19994. Overfull \hbox (10.55888pt too wide) in paragraph at lines 19994--19994 []\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 19994--19994 \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 19994--19994 \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 1999 4. Overfull \hbox (42.09962pt too wide) in paragraph at lines 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 199 94. LaTeX Warning: Hyper reference `Ellipse' on page 337 undefined on input line 19 994. LaTeX Warning: Hyper reference `Prism' on page 337 undefined on input line 1999 4. LaTeX Warning: Hyper reference `Object' on page 337 undefined on input line 199 94. Overfull \hbox (5.62103pt too wide) in paragraph at lines 19994--19994 []\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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994. LaTeX Warning: Hyper reference `astSimplify' on page 337 undefined on input lin e 19994. Overfull \hbox (5.3586pt too wide) in paragraph at lines 19994--19994 []\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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 199 94. Overfull \hbox (10.86975pt too wide) in paragraph at lines 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 [] \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 19994--19994 \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 19994--19994 \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 19994--19994 [][]\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 19994--19994 []\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 19994--19994 \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 0086. LaTeX Warning: Hyper reference `Mapping' on page 339 undefined on input line 20 086. LaTeX Warning: Hyper reference `astIntraReg' on page 339 undefined on input lin e 20086. Overfull \hbox (5.52135pt too wide) in paragraph at lines 20086--20086 []\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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 86. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 [] \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 20086--20086 \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 20086--20086 \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 86. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20086--20086 [][]\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 0269. LaTeX Warning: Hyper reference `Mapping' on page 341 undefined on input line 20 269. LaTeX Warning: Hyper reference `astIntraMap' on page 341 undefined on input lin e 20269. LaTeX Warning: Hyper reference `Channel' on page 341 undefined on input line 20 269. Overfull \hbox (5.78378pt too wide) in paragraph at lines 20269--20269 []\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 0269. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 []\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 20269--20269 \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 20269--20269 \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 20269. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 269. LaTeX Warning: Hyper reference `astSimplify' on page 342 undefined on input lin e 20269. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20269--20269 [][]\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 20269--20269 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 20269--20269 \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 20269--20269 \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 20269--20269 \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 294. LaTeX Warning: Hyper reference `Invert' on page 344 undefined on input line 202 94. [344] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. LaTeX Warning: Hyper reference `Object' on page 345 undefined on input line 203 57. LaTeX Warning: Hyper reference `Class' on page 345 undefined on input line 2035 7. Overfull \hbox (3.47949pt too wide) in paragraph at lines 20357--20357 \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 2035 7. Underfull \hbox (badness 10000) in paragraph at lines 20357--20357 Underfull \hbox (badness 10000) in paragraph at lines 20357--20357 [] \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 20357--20357 [][]\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 20357--20357 [][]\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 20357--20357 \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 20357--20357 [][]\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 20357--20357 \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 32. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 346 undefined on inp ut line 20432. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 346 undefined on inp ut line 20432. LaTeX Warning: Hyper reference `KeyCase' on page 346 undefined on input line 20 432. LaTeX Warning: Hyper reference `Object' on page 346 undefined on input line 204 32. LaTeX Warning: Hyper reference `Mapping' on page 346 undefined on input line 20 432. LaTeX Warning: Hyper reference `astSet' on page 346 undefined on input line 204 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20432--20432 \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 20432--20432 \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 20432--20432 \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 20432--20432 [] \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 20432--20432 \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 20432--20432 \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 20432--20432 [][]\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 20432--20432 []\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 20432--20432 \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 550. Overfull \hbox (18.90558pt too wide) in paragraph at lines 20550--20550 []\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 20550. Overfull \hbox (26.6159pt too wide) in paragraph at lines 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.36719pt too wide) in paragraph at lines 20550--20550 [] \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550 . Overfull \hbox (21.10475pt too wide) in paragraph at lines 20550--20550 [] \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550. Overfull \hbox (0.37231pt too wide) in paragraph at lines 20550--20550 [][]\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 20550--20550 \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 20550--20550 [][]\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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 [][]\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 20550--20550 [][]\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 20550--20550 \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 20550--20550 \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 28. LaTeX Warning: Hyper reference `astUnlock' on page 349 undefined on input line 20628. Overfull \hbox (21.10475pt too wide) in paragraph at lines 20628--20628 \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 20628--20628 \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 20628--20628 \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 20628--20628 \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 0628. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20628--20628 [][]\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 20628--20628 \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 20628--20628 [][]\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 628. Overfull \hbox (26.35347pt too wide) in paragraph at lines 20628--20628 [][]\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 20628--20628 \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 20628--20628 \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 20628--20628 \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 20628--20628 [][]\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 20628--20628 \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 39. LaTeX Warning: Hyper reference `Mapping' on page 350 undefined on input line 20 739. Overfull \hbox (7.72334pt too wide) in paragraph at lines 20739--20739 []\T1/cmtt/m/n/10 AstLutMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astLutMap( in t nlut, const double lut[], double start, double inc, const Overfull \hbox (36.8509pt too wide) in paragraph at lines 20739--20739 \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 20739--20739 \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 39. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20739--20739 \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 20739--20739 \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 20739--20739 \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 20739--20739 [] \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 20739--20739 \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 20739--20739 \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 20739. Overfull \hbox (26.6159pt too wide) in paragraph at lines 20739--20739 [][]\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 20739--20739 \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 20739--20739 \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 20739--20739 \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 39. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20739--20739 [][]\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 20739--20739 []\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 20739--20739 \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 882. Overfull \hbox (18.22078pt too wide) in paragraph at lines 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882 . Overfull \hbox (41.83719pt too wide) in paragraph at lines 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.6159pt too wide) in paragraph at lines 20882--20882 [] \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 20882--20882 \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 20882--20882 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [352] Overfull \hbox (26.6159pt too wide) in paragraph at lines 20882--20882 [] \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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 28. Overfull \hbox (31.86462pt too wide) in paragraph at lines 20928--20928 [][]\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 20928--20928 [][]\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 20928--20928 \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 20928--20928 \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 20928--20928 \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 20928. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20928--20928 [][]\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 20928--20928 \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 92. Overfull \hbox (2.89699pt too wide) in paragraph at lines 20992--20992 []\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 992. Overfull \hbox (0.10988pt too wide) in paragraph at lines 20992--20992 \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 20992--20992 \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 20992. Overfull \hbox (5.62103pt too wide) in paragraph at lines 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 [][]\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 20992--20992 [][]\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 20992. Overfull \hbox (10.86975pt too wide) in paragraph at lines 20992--20992 [][]\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 20992--20992 \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 30. LaTeX Warning: Hyper reference `astMapHasKey' on page 356 undefined on input li ne 21030. LaTeX Warning: Hyper reference `KeyCase' on page 356 undefined on input line 21 030. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21030--21030 \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 21030--21030 \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 21030--21030 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. LaTeX Warning: Hyper reference `KeyMap' on page 357 undefined on input line 211 57. LaTeX Warning: Hyper reference `KeyCase' on page 357 undefined on input line 21 157. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21157--21157 \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 21157--21157 \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 21157. Overfull \hbox (10.60732pt too wide) in paragraph at lines 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 [][]\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 21157--21157 \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 21157--21157 [][]\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 157. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21157--21157 [][]\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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 57. LaTeX Warning: Hyper reference `astAnnul' on page 357 undefined on input line 2 1157. Overfull \hbox (0.37231pt too wide) in paragraph at lines 21157--21157 [][]\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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 []\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 21157--21157 \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 21157--21157 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. LaTeX Warning: Hyper reference `KeyMap' on page 359 undefined on input line 213 01. Overfull \hbox (15.56409pt too wide) in paragraph at lines 21301--21301 []\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 21301--21301 \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 301. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21301--21301 \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 21301--21301 \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 21301--21301 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the LaTeX Warning: Hyper reference `astMapPutU' on page 359 undefined on input line 21301. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 [][]\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 21301--21301 \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 21301--21301 [][]\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 21301--21301 []\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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 []\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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 71. LaTeX Warning: Hyper reference `KeyCase' on page 361 undefined on input line 21 371. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21371--21371 \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 21371--21371 \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 21371. Overfull \hbox (36.8509pt too wide) in paragraph at lines 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 [][]\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 21371--21371 \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 371. Overfull \hbox (10.86975pt too wide) in paragraph at lines 21371--21371 [][]\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 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. LaTeX Warning: Hyper reference `KeyMap' on page 362 undefined on input line 215 02. Overfull \hbox (5.06665pt too wide) in paragraph at lines 21502--21502 []\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 21502--21502 \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 502. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502. Overfull \hbox (10.60732pt too wide) in paragraph at lines 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 [][]\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 21502--21502 \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 21502--21502 []\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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 []\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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 54. LaTeX Warning: Hyper reference `KeyCase' on page 364 undefined on input line 21 554. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21554--21554 \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 21554--21554 \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 21554. Overfull \hbox (26.6159pt too wide) in paragraph at lines 21554--21554 [][]\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 21554--21554 \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 21554--21554 [][]\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 14. LaTeX Warning: Hyper reference `astMapSize' on page 365 undefined on input line 21614. LaTeX Warning: Hyper reference `SortBy' on page 365 undefined on input line 216 14. Overfull \hbox (26.09103pt too wide) in paragraph at lines 21614--21614 \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 21614--21614 \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 21614--21614 [][]\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 21614--21614 \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 21614--21614 \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 21614--21614 [][]\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 66. LaTeX Warning: Hyper reference `KeyCase' on page 366 undefined on input line 21 666. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21666--21666 \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 21666--21666 \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 21666--21666 \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 21666--21666 [][]\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 21666--21666 [][]\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 11. LaTeX Warning: Hyper reference `KeyCase' on page 367 undefined on input line 21 711. Overfull \hbox (12.18193pt too wide) in paragraph at lines 21711--21711 \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 21711--21711 \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 21711--21711 \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 21711--21711 [][]\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. LaTeX Warning: Hyper reference `KeyMap' on page 368 undefined on input line 218 21. Overfull \hbox (46.79396pt too wide) in paragraph at lines 21821--21821 []\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 821. Overfull \hbox (31.33975pt too wide) in paragraph at lines 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 [][]\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 21. Overfull \hbox (5.62103pt too wide) in paragraph at lines 21821--21821 [][]\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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 []\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 21821--21821 \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 21821--21821 \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 821. LaTeX Warning: Hyper reference `astWrite' on page 369 undefined on input line 2 1821. Overfull \hbox (7.98578pt too wide) in paragraph at lines 21821--21821 []\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. LaTeX Warning: Hyper reference `KeyMap' on page 370 undefined on input line 219 25. Overfull \hbox (33.46098pt too wide) in paragraph at lines 21925--21925 []\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 925. Overfull \hbox (36.58847pt too wide) in paragraph at lines 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 [][]\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 21925--21925 []\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 21925--21925 \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 21925--21925 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I LaTeX Warning: Hyper reference `astShow' on page 370 undefined on input line 21 925. LaTeX Warning: Hyper reference `astWrite' on page 370 undefined on input line 2 1925. Overfull \hbox (7.98578pt too wide) in paragraph at lines 21925--21925 []\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 [370] [371] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. LaTeX Warning: Hyper reference `KeyMap' on page 372 undefined on input line 220 50. Overfull \hbox (4.59303pt too wide) in paragraph at lines 22050--22050 []\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 050. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 2205 0. LaTeX Warning: Hyper reference `astAddColumn' on page 372 undefined on input li ne 22050. Overfull \hbox (4.1005pt too wide) in paragraph at lines 22050--22050 \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 22050--22050 \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 22050--22050 [][]\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 22050--22050 [][]\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 22050--22050 \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 22050--22050 []\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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 00. LaTeX Warning: Hyper reference `MapLocked' on page 374 undefined on input line 22100. LaTeX Warning: Hyper reference `KeyCase' on page 374 undefined on input line 22 100. Overfull \hbox (31.33975pt too wide) in paragraph at lines 22100--22100 \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 22100--22100 \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 22100--22100 \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 22100--22100 [][]\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 68. LaTeX Warning: Hyper reference `Mapping' on page 375 undefined on input line 22 168. LaTeX Warning: Hyper reference `PermMap' on page 375 undefined on input line 22 168. LaTeX Warning: Hyper reference `MathMap' on page 375 undefined on input line 22 168. LaTeX Warning: Hyper reference `SphMap' on page 375 undefined on input line 221 68. Overfull \hbox (47.61078pt too wide) in paragraph at lines 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 2216 8. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22168--22168 \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 22168--22168 \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 22168--22168 [][]\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 68. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22168--22168 [][]\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 221 97. LaTeX Warning: Hyper reference `KeyCase' on page 376 undefined on input line 22 197. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22197--22197 \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 22197--22197 \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 34. LaTeX Warning: Hyper reference `KeyCase' on page 377 undefined on input line 22 234. Overfull \hbox (5.3586pt too wide) in paragraph at lines 22234--22234 \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 22234--22234 \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 22234--22234 \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 22234--22234 \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 68. Overfull \hbox (5.3586pt too wide) in paragraph at lines 22268--22268 [][]\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 351. Overfull \hbox (24.31422pt too wide) in paragraph at lines 22351--22351 []\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 22351. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22351--22351 [] \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 [][]\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 22351--22351 \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 10. LaTeX Warning: Hyper reference `KeyCase' on page 380 undefined on input line 22 410. Overfull \hbox (12.18193pt too wide) in paragraph at lines 22410--22410 \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 22410--22410 \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 22410--22410 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__BYTETYPE (for LaTeX Warning: Hyper reference `Object' on page 380 undefined on input line 224 10. LaTeX Warning: Hyper reference `astMapPutU' on page 380 undefined on input line 22410. Overfull \hbox (79.10309pt too wide) in paragraph at lines 22410--22410 [][]\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 22410--22410 \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 22410--22410 \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 22410--22410 \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 22410--22410 [][]\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 22496 . Overfull \hbox (13.18324pt too wide) in paragraph at lines 22496--22496 []\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 22496--22496 \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 2249 6. LaTeX Warning: Hyper reference `Naxes' on page 381 undefined on input line 2249 6. Overfull \hbox (15.85603pt too wide) in paragraph at lines 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 22496--22496 [] \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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 [][]\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 22496--22496 \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 496. Overfull \hbox (5.62103pt too wide) in paragraph at lines 22496--22496 [][]\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 22496. Overfull \hbox (10.86975pt too wide) in paragraph at lines 22496--22496 [][]\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. LaTeX Warning: Hyper reference `Region' on page 382 undefined on input line 227 13. Overfull \hbox (3.90186pt too wide) in paragraph at lines 22713--22713 []\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 713. LaTeX Warning: Hyper reference `UnitMap' on page 382 undefined on input line 22 713. Overfull \hbox (0.37231pt too wide) in paragraph at lines 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713. LaTeX Warning: Hyper reference `Naxes' on page 382 undefined on input line 2271 3. LaTeX Warning: Hyper reference `Nout' on page 382 undefined on input line 22713 . Overfull \hbox (26.35347pt too wide) in paragraph at lines 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 713. Overfull \hbox (26.35347pt too wide) in paragraph at lines 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713. Overfull \hbox (16.11847pt too wide) in paragraph at lines 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 [] \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 [][]\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 22713--22713 [][]\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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 2277 5. LaTeX Warning: Hyper reference `Axis' on page 385 undefined on input line 22775 . Overfull \hbox (5.62103pt too wide) in paragraph at lines 22775--22775 \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 22775--22775 \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 22775--22775 \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 22775--22775 []\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 775. LaTeX Warning: Hyper reference `astFindFrame' on page 385 undefined on input li ne 22775. LaTeX Warning: Hyper reference `astConvert' on page 385 undefined on input line 22775. LaTeX Warning: Hyper reference `SkyFrame' on page 385 undefined on input line 2 2775. Overfull \hbox (21.36719pt too wide) in paragraph at lines 22775--22775 [][]\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 22775--22775 \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 22775--22775 \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 512. LaTeX Warning: Hyper reference `Mapping' on page 386 undefined on input line 23 512. LaTeX Warning: Hyper reference `IntraMap' on page 386 undefined on input line 2 3512. Overfull \hbox (28.9294pt too wide) in paragraph at lines 23512--23512 []\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 23512. Overfull \hbox (16.11847pt too wide) in paragraph at lines 23512--23512 \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 23512 . Overfull \hbox (0.37231pt too wide) in paragraph at lines 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 12. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [] \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 23512--23512 \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 23512--23512 \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 23512 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 23512--23512 [][]\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 23512--23512 \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 23512. LaTeX Warning: Hyper reference `SimpFI' on page 387 undefined on input line 235 12. LaTeX Warning: Hyper reference `SimpIF' on page 387 undefined on input line 235 12. Overfull \hbox (16.11847pt too wide) in paragraph at lines 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 12. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23512--23512 [][]\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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 []\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 []\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 23512--23512 [][]$\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 23512--23512 \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 23512--23512 [][]$\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 23512 . Overfull \hbox (26.37558pt too wide) in paragraph at lines 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23633. LaTeX Warning: Hyper reference `Mapping' on page 394 undefined on input line 23 633. Overfull \hbox (18.22078pt too wide) in paragraph at lines 23633--23633 []\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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 \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 33. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 [] \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 23633--23633 \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 23633--23633 \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 23633. LaTeX Warning: Hyper reference `TranInverse' on page 394 undefined on input lin e 23633. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23633--23633 [][]\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 23633--23633 \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 23633--23633 \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 23633--23633 [][]\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 23633--23633 \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 23633--23633 \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 23633--23633 \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 33. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23633--23633 [][]\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 23633--23633 []\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 23633--23633 \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 706. LaTeX Warning: Hyper reference `Frame' on page 396 undefined on input line 2370 6. LaTeX Warning: Hyper reference `FrameSet' on page 396 undefined on input line 2 3706. LaTeX Warning: Hyper reference `Mapping' on page 396 undefined on input line 23 706. LaTeX Warning: Hyper reference `Nframe' on page 396 undefined on input line 237 06. Overfull \hbox (21.10475pt too wide) in paragraph at lines 23706--23706 \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 23706--23706 \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 23706--23706 \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 23706--23706 \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 23706--23706 [][]\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 23706--23706 \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 23706. Overfull \hbox (15.85603pt too wide) in paragraph at lines 23706--23706 [][]\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 23706--23706 \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 23706--23706 [][]\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 23706--23706 [][]\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 23805. LaTeX Warning: Hyper reference `Region' on page 397 undefined on input line 238 05. LaTeX Warning: Hyper reference `Adaptive' on page 397 undefined on input line 2 3805. LaTeX Warning: Hyper reference `astGetMocData' on page 397 undefined on input l ine 23805. LaTeX Warning: Hyper reference `astGetMocHeader' on page 397 undefined on input line 23805. LaTeX Warning: Hyper reference `astAddMocData' on page 397 undefined on input l ine 23805. Underfull \hbox (badness 10000) in paragraph at lines 23805--23805 LaTeX Warning: Hyper reference `astSet' on page 397 undefined on input line 238 05. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23805--23805 \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 23805--23805 \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 23805--23805 \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 23805--23805 [] \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 23805--23805 \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 23805--23805 \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 05. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23805--23805 [][]\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 23805--23805 []\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 23805--23805 \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 912. LaTeX Warning: Hyper reference `Channel' on page 399 undefined on input line 23 912. LaTeX Warning: Hyper reference `Moc' on page 399 undefined on input line 23912. LaTeX Warning: Hyper reference `astWrite' on page 399 undefined on input line 2 3912. LaTeX Warning: Hyper reference `SinkFile' on page 399 undefined on input line 2 3912. LaTeX Warning: Hyper reference `SourceFile' on page 399 undefined on input line 23912. Overfull \hbox (8.56807pt too wide) in paragraph at lines 23912--23912 []\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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 []\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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 []\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 12. Overfull \hbox (10.86975pt too wide) in paragraph at lines 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 [] \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 23912--23912 \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 23912--23912 \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 23912--23912 [][]\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 23912--23912 \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 12. Overfull \hbox (5.62103pt too wide) in paragraph at lines 23912--23912 [][]\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 35. LaTeX Warning: Hyper reference `Negated' on page 401 undefined on input line 23 935. [401] LaTeX Warning: Hyper reference `Frame' on page 402 undefined on input line 2399 2. LaTeX Warning: Hyper reference `Naxes' on page 402 undefined on input line 2399 2. Overfull \hbox (49.9727pt too wide) in paragraph at lines 23992--23992 \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 23992--23992 \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 23992--23992 \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 23992--23992 \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 23992--23992 [][]\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 23992--23992 \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 23992--23992 \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 23 992. LaTeX Warning: Hyper reference `Mapping' on page 402 undefined on input line 23 992. Overfull \hbox (0.37231pt too wide) in paragraph at lines 23992--23992 [][]\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 23992. Overfull \hbox (16.11847pt too wide) in paragraph at lines 23992--23992 [][]\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 23992--23992 \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 072. LaTeX Warning: Hyper reference `Mapping' on page 403 undefined on input line 24 072. LaTeX Warning: Hyper reference `astNorm' on page 403 undefined on input line 24 072. LaTeX Warning: Hyper reference `Frame' on page 403 undefined on input line 2407 2. LaTeX Warning: Hyper reference `astSimplify' on page 403 undefined on input lin e 24072. LaTeX Warning: Hyper reference `UnitMap' on page 403 undefined on input line 24 072. LaTeX Warning: Hyper reference `CmpMap' on page 403 undefined on input line 240 72. Overfull \hbox (17.43065pt too wide) in paragraph at lines 24072--24072 \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 72. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24072--24072 \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 24072--24072 \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 24072--24072 \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 24072--24072 [] \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 24072--24072 \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 24072--24072 \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 72. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24072--24072 [][]\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 24072--24072 []\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 24072--24072 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [403] LaTeX Warning: Hyper reference `NullRegion' on page 404 undefined on input line 24157. LaTeX Warning: Hyper reference `Region' on page 404 undefined on input line 241 57. LaTeX Warning: Hyper reference `Negated' on page 404 undefined on input line 24 157. Overfull \hbox (5.73253pt too wide) in paragraph at lines 24157--24157 []\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 404 undefined on input line 2415 7. Overfull \hbox (10.60732pt too wide) in paragraph at lines 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 404 undefined on input line 24157. LaTeX Warning: Hyper reference `Circle' on page 404 undefined on input line 241 57. LaTeX Warning: Hyper reference `Ellipse' on page 404 undefined on input line 24 157. LaTeX Warning: Hyper reference `Prism' on page 404 undefined on input line 2415 7. LaTeX Warning: Hyper reference `Object' on page 404 undefined on input line 241 57. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24157--24157 []\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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 404 undefined on input line 241 57. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 [] \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 24157--24157 \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 24157--24157 \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 24157--24157 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [404] LaTeX Warning: Hyper reference `astClearStatus' on page 405 undefined on input line 24190. Overfull \hbox (42.36206pt too wide) in paragraph at lines 24190--24190 [][]\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 24190--24190 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [405] LaTeX Warning: Hyper reference `Frame' on page 406 undefined on input line 2426 6. Overfull \hbox (12.97206pt too wide) in paragraph at lines 24266--24266 []\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 406 undefined on input line 2426 6. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 406 undefined on input lin e 24266. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24266--24266 [][]\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 24266--24266 [][]\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 24266--24266 [][]\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 24266--24266 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [406] LaTeX Warning: Hyper reference `Frame' on page 407 undefined on input line 2435 2. Overfull \hbox (26.3563pt too wide) in paragraph at lines 24352--24352 []\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 407 undefined on input line 2435 2. Overfull \hbox (21.10475pt too wide) in paragraph at lines 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 407 undefined on input lin e 24352. Overfull \hbox (21.36719pt too wide) in paragraph at lines 24352--24352 [][]\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 24352--24352 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [407] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. LaTeX Warning: Hyper reference `Polygon' on page 408 undefined on input line 24 637. LaTeX Warning: Hyper reference `Frame' on page 408 undefined on input line 2463 7. LaTeX Warning: Hyper reference `Domain' on page 408 undefined on input line 246 37. LaTeX Warning: Hyper reference `Title' on page 408 undefined on input line 2463 7. Overfull \hbox (10.58418pt too wide) in paragraph at lines 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [408] Overfull \hbox (0.37231pt too wide) in paragraph at lines 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 [409] LaTeX Warning: Hyper reference `astDownsize' on page 410 undefined on input lin e 24637. Overfull \hbox (26.6159pt too wide) in paragraph at lines 24637--24637 [][]\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 24637--24637 [][]\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 [][]\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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 >$ [410] LaTeX Warning: Hyper reference `Region' on page 411 undefined on input line 247 03. Overfull \hbox (12.76088pt too wide) in paragraph at lines 24703--24703 \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 24703--24703 []\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 24703--24703 []\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 411 undefined on input line 247 03. Overfull \hbox (0.37231pt too wide) in paragraph at lines 24703--24703 [][]\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 24703--24703 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [411] LaTeX Warning: Hyper reference `Table' on page 412 undefined on input line 2476 4. LaTeX Warning: Hyper reference `Nparameter' on page 412 undefined on input line 24764. Overfull \hbox (5.3586pt too wide) in paragraph at lines 24764--24764 \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 24764--24764 [][]\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 24764--24764 \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 24764--24764 \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 24764--24764 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [412] LaTeX Warning: Hyper reference `PcdMap' on page 413 undefined on input line 248 67. LaTeX Warning: Hyper reference `Mapping' on page 413 undefined on input line 24 867. LaTeX Warning: Hyper reference `Disco' on page 413 undefined on input line 2486 7. LaTeX Warning: Hyper reference `astInvert' on page 413 undefined on input line 24867. Overfull \hbox (9.50914pt too wide) in paragraph at lines 24867--24867 []\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 24867--24867 \T1/cmtt/m/n/10 The distortion coefficient. Negative values give barrel distort ion, positive LaTeX Warning: Hyper reference `astSet' on page 413 undefined on input line 248 67. Overfull \hbox (10.86975pt too wide) in paragraph at lines 24867--24867 \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 24867--24867 \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 24867--24867 \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 24867--24867 [] \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 24867--24867 \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 24867--24867 \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 413 undefined on input line 248 67. Overfull \hbox (5.62103pt too wide) in paragraph at lines 24867--24867 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [413] Overfull \hbox (2.26344pt too wide) in paragraph at lines 24867--24867 []\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 24867--24867 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [414] LaTeX Warning: Hyper reference `Frame' on page 415 undefined on input line 2490 6. LaTeX Warning: Hyper reference `Naxes' on page 415 undefined on input line 2490 6. Overfull \hbox (0.10988pt too wide) in paragraph at lines 24906--24906 \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 24906--24906 \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 24906--24906 [][]\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 24906--24906 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [415] LaTeX Warning: Hyper reference `PermMap' on page 416 undefined on input line 25 044. LaTeX Warning: Hyper reference `Mapping' on page 416 undefined on input line 25 044. Overfull \hbox (5.09898pt too wide) in paragraph at lines 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 \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 25044--25044 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [416] LaTeX Warning: Hyper reference `astSet' on page 417 undefined on input line 250 44. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 [] \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 25044--25044 \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 25044--25044 \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 25044--25044 [][]\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 25044--25044 \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 25044--25044 [][]\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 25044--25044 \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 25044--25044 \T1/cmtt/m/n/10 to supply coordinate permutation arrays that achieve whatever e ffect is desired. LaTeX Warning: Hyper reference `Object' on page 417 undefined on input line 250 44. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25044--25044 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [417] LaTeX Warning: Hyper reference `Frame' on page 418 undefined on input line 2515 6. LaTeX Warning: Hyper reference `Title' on page 418 undefined on input line 2515 6. LaTeX Warning: Hyper reference `Mapping' on page 418 undefined on input line 25 156. Overfull \hbox (13.6056pt too wide) in paragraph at lines 25156--25156 []\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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 418 undefined on input line 25 156. LaTeX Warning: Hyper reference `UnitMap' on page 418 undefined on input line 25 156. Overfull \hbox (10.60732pt too wide) in paragraph at lines 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 []\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 25156--25156 LaTeX Warning: Hyper reference `SkyFrame' on page 418 undefined on input line 2 5156. Overfull \hbox (23.25832pt too wide) in paragraph at lines 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 418 undefined on input line 2 5156. Overfull \hbox (2.52588pt too wide) in paragraph at lines 25156--25156 \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 418 undefined on input line 251 56. LaTeX Warning: Hyper reference `Box' on page 418 undefined on input line 25156. LaTeX Warning: Hyper reference `Circle' on page 418 undefined on input line 251 56. Overfull \hbox (39.2669pt too wide) in paragraph at lines 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [418] LaTeX Warning: Hyper reference `astCopy' on page 419 undefined on input line 25 156. Overfull \hbox (26.6159pt too wide) in paragraph at lines 25156--25156 [][]\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 25156--25156 \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 419 undefined on input line 251 56. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25156--25156 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [419] LaTeX Warning: Hyper reference `Plot' on page 420 undefined on input line 25329 . LaTeX Warning: Hyper reference `FrameSet' on page 420 undefined on input line 2 5329. LaTeX Warning: Hyper reference `Frame' on page 420 undefined on input line 2532 9. LaTeX Warning: Hyper reference `Mapping' on page 420 undefined on input line 25 329. LaTeX Warning: Hyper reference `astCurve' on page 420 undefined on input line 2 5329. LaTeX Warning: Hyper reference `astMark' on page 420 undefined on input line 25 329. LaTeX Warning: Hyper reference `astText' on page 420 undefined on input line 25 329. LaTeX Warning: Hyper reference `astGridLine' on page 420 undefined on input lin e 25329. LaTeX Warning: Hyper reference `astGrid' on page 420 undefined on input line 25 329. LaTeX Warning: Hyper reference `Current' on page 420 undefined on input line 25 329. LaTeX Warning: Hyper reference `astClip' on page 420 undefined on input line 25 329. Overfull \hbox (7.93452pt too wide) in paragraph at lines 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 420 undefined on input line 253 29. LaTeX Warning: Hyper reference `Label(axis)' on page 420 undefined on input lin e 25329. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [420] Overfull \hbox (5.3586pt too wide) in paragraph at lines 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 421 undefined on input line 253 29. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [] \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 25329--25329 \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 25329--25329 \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 421 undefined on input line 25329 . Overfull \hbox (16.11847pt too wide) in paragraph at lines 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 421 undefined on input line 2532 9. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [421] LaTeX Warning: Hyper reference `Plot3D' on page 422 undefined on input line 254 65. LaTeX Warning: Hyper reference `Plot' on page 422 undefined on input line 25465 . Overfull \hbox (28.9294pt too wide) in paragraph at lines 25465--25465 []\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 422 undefined on input line 2546 5. LaTeX Warning: Hyper reference `FrameSet' on page 422 undefined on input line 2 5465. Overfull \hbox (1.94693pt too wide) in paragraph at lines 25465--25465 \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 25465--25465 \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 25465--25465 \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 65. LaTeX Warning: Hyper reference `Label(axis)' on page 422 undefined on input lin e 25465. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25465--25465 []\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 []\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 422 undefined on input line 254 65. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [] \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 25465--25465 \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 25465--25465 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [422] LaTeX Warning: Hyper reference `Base' on page 423 undefined on input line 25465 . Overfull \hbox (0.10988pt too wide) in paragraph at lines 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 423 undefined on input line 2546 5. Overfull \hbox (21.36719pt too wide) in paragraph at lines 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 25465--25465 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [423] LaTeX Warning: Hyper reference `Region' on page 424 undefined on input line 255 22. Overfull \hbox (26.35347pt too wide) in paragraph at lines 25522--25522 \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 25522--25522 \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 25522--25522 LaTeX Warning: Hyper reference `Mapping' on page 424 undefined on input line 25 522. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25522--25522 [][]\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 25522--25522 \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 25522--25522 \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 [424] LaTeX Warning: Hyper reference `PointList' on page 425 undefined on input line 25655. LaTeX Warning: Hyper reference `Region' on page 425 undefined on input line 256 55. LaTeX Warning: Hyper reference `Frame' on page 425 undefined on input line 2565 5. Overfull \hbox (34.17812pt too wide) in paragraph at lines 25655--25655 []\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 25655--25655 \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 25655--25655 \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 425 undefined on input line 2565 5. Overfull \hbox (0.10988pt too wide) in paragraph at lines 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \T1/cmtt/m/n/10 uncertainty Region then represents the uncertainty in the posit ion. The uncertainty LaTeX Warning: Hyper reference `Box' on page 425 undefined on input line 25655. LaTeX Warning: Hyper reference `Circle' on page 425 undefined on input line 256 55. LaTeX Warning: Hyper reference `Ellipse' on page 425 undefined on input line 25 655. LaTeX Warning: Hyper reference `Prism' on page 425 undefined on input line 2565 5. LaTeX Warning: Hyper reference `Object' on page 425 undefined on input line 256 55. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25655--25655 []\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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 425 undefined on input line 25655. LaTeX Warning: Hyper reference `astSimplify' on page 425 undefined on input lin e 25655. Overfull \hbox (5.3586pt too wide) in paragraph at lines 25655--25655 []\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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [425] LaTeX Warning: Hyper reference `astSet' on page 426 undefined on input line 256 55. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 [] \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 25655--25655 \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 25655--25655 \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 25655--25655 [][]\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 25655--25655 []\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 25655--25655 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [426] LaTeX Warning: Hyper reference `PolyMap' on page 427 undefined on input line 25 732. Overfull \hbox (29.14058pt too wide) in paragraph at lines 25732--25732 []\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 427 undefined on input line 25 732. Overfull \hbox (17.69308pt too wide) in paragraph at lines 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 []\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 25732--25732 \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 25732--25732 \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 25732--25732 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [427] LaTeX Warning: Hyper reference `Plot' on page 428 undefined on input line 25809 . LaTeX Warning: Hyper reference `astCurve' on page 428 undefined on input line 2 5809. LaTeX Warning: Hyper reference `Mapping' on page 428 undefined on input line 25 809. LaTeX Warning: Hyper reference `astClip' on page 428 undefined on input line 25 809. Overfull \hbox (18.43196pt too wide) in paragraph at lines 25809--25809 []\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 428 undefined on input line 2580 9. LaTeX Warning: Hyper reference `Naxes' on page 428 undefined on input line 2580 9. Overfull \hbox (21.10475pt too wide) in paragraph at lines 25809--25809 \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 25809--25809 \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 25809--25809 \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 25809--25809 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 25809--25809 [] \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 25809--25809 \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 25809--25809 \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 25809--25809 \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 25809--25809 [][]\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 428 undefined on input lin e 25809. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25809--25809 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [428] LaTeX Warning: Hyper reference `PolyMap' on page 429 undefined on input line 25 936. LaTeX Warning: Hyper reference `Mapping' on page 429 undefined on input line 25 936. LaTeX Warning: Hyper reference `IterInverse' on page 429 undefined on input lin e 25936. Overfull \hbox (12.97206pt too wide) in paragraph at lines 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [429] LaTeX Warning: Hyper reference `astSet' on page 430 undefined on input line 259 36. Overfull \hbox (10.86975pt too wide) in paragraph at lines 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 [] \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 25936--25936 \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 25936--25936 \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 430 undefined on input line 259 36. Overfull \hbox (5.62103pt too wide) in paragraph at lines 25936--25936 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [430] LaTeX Warning: Hyper reference `PolyMap' on page 431 undefined on input line 26 111. LaTeX Warning: Hyper reference `Mapping' on page 431 undefined on input line 26 111. Overfull \hbox (31.86462pt too wide) in paragraph at lines 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [431] LaTeX Warning: Hyper reference `Nin' on page 432 undefined on input line 26111. LaTeX Warning: Hyper reference `Nout' on page 432 undefined on input line 26111 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 432 undefined on input line 2 6111. Overfull \hbox (2.001pt too wide) in paragraph at lines 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 432 undefined on input lin e 26111. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26111--26111 [][]\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 26111--26111 \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 26111--26111 \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 26111--26111 [][]\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 432 undefined on input line 261 11. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26111--26111 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [432] LaTeX Warning: Hyper reference `Polygon' on page 433 undefined on input line 26 256. LaTeX Warning: Hyper reference `Frame' on page 433 undefined on input line 2625 6. LaTeX Warning: Hyper reference `SkyFrame' on page 433 undefined on input line 2 6256. Overfull \hbox (50.13545pt too wide) in paragraph at lines 26256--26256 []\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 433 undefined on input line 262 56. Overfull \hbox (5.3586pt too wide) in paragraph at lines 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 433 undefined on input line 26256. LaTeX Warning: Hyper reference `Circle' on page 433 undefined on input line 262 56. LaTeX Warning: Hyper reference `Ellipse' on page 433 undefined on input line 26 256. LaTeX Warning: Hyper reference `Prism' on page 433 undefined on input line 2625 6. LaTeX Warning: Hyper reference `Object' on page 433 undefined on input line 262 56. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26256--26256 []\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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [433] LaTeX Warning: Hyper reference `astOverlap' on page 434 undefined on input line 26256. LaTeX Warning: Hyper reference `astSimplify' on page 434 undefined on input lin e 26256. Overfull \hbox (5.3586pt too wide) in paragraph at lines 26256--26256 []\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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by LaTeX Warning: Hyper reference `astSet' on page 434 undefined on input line 262 56. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 [] \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 26256--26256 \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 26256--26256 \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 26256--26256 [][]\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 26256--26256 []\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 26256--26256 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [434] LaTeX Warning: Hyper reference `Prism' on page 435 undefined on input line 2633 5. LaTeX Warning: Hyper reference `Region' on page 435 undefined on input line 263 35. LaTeX Warning: Hyper reference `Circle' on page 435 undefined on input line 263 35. LaTeX Warning: Hyper reference `Interval' on page 435 undefined on input line 2 6335. Overfull \hbox (9.9315pt too wide) in paragraph at lines 26335--26335 []\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 435 undefined on input line 263 35. Overfull \hbox (10.86975pt too wide) in paragraph at lines 26335--26335 \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 26335--26335 \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 26335--26335 \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 26335--26335 [] \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 26335--26335 \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 26335--26335 \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 26335--26335 [][]\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 26335--26335 \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 435 undefined on input line 263 35. Overfull \hbox (5.62103pt too wide) in paragraph at lines 26335--26335 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [435] LaTeX Warning: Hyper reference `Table' on page 436 undefined on input line 2635 5. [436] LaTeX Warning: Hyper reference `FitsChan' on page 437 undefined on input line 2 6377. [437] LaTeX Warning: Hyper reference `FitsChan' on page 438 undefined on input line 2 6423. LaTeX Warning: Hyper reference `Card' on page 438 undefined on input line 26423 . LaTeX Warning: Hyper reference `astRead' on page 438 undefined on input line 26 423. Overfull \hbox (0.37231pt too wide) in paragraph at lines 26423--26423 \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 26423--26423 \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 26423--26423 \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 26423--26423 \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 26423--26423 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [438] LaTeX Warning: Hyper reference `Channel' on page 439 undefined on input line 26 467. LaTeX Warning: Hyper reference `astChannelData' on page 439 undefined on input line 26467. Overfull \hbox (47.34834pt too wide) in paragraph at lines 26467--26467 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [439] Overfull \hbox (15.8076pt too wide) in paragraph at lines 26525--26525 []\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 440 undefined on input line 26525. Overfull \hbox (22.67937pt too wide) in paragraph at lines 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [440] LaTeX Warning: Hyper reference `FitsChan' on page 441 undefined on input line 2 6578. LaTeX Warning: Hyper reference `Card' on page 441 undefined on input line 26578 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 [][]\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 26578--26578 \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 26578--26578 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [441] LaTeX Warning: Hyper reference `FitsChan' on page 442 undefined on input line 2 6632. LaTeX Warning: Hyper reference `astRead' on page 442 undefined on input line 26 632. LaTeX Warning: Hyper reference `FitsTable' on page 442 undefined on input line 26632. Overfull \hbox (52.8595pt too wide) in paragraph at lines 26632--26632 \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 26632--26632 \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 26632--26632 \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 442 undefined on input li ne 26632. LaTeX Warning: Hyper reference `astPutTables' on page 442 undefined on input li ne 26632. [442] LaTeX Warning: Hyper reference `FitsTable' on page 443 undefined on input line 26678. LaTeX Warning: Hyper reference `FitsChan' on page 443 undefined on input line 2 6678. LaTeX Warning: Hyper reference `Table' on page 443 undefined on input line 2667 8. Overfull \hbox (16.11847pt too wide) in paragraph at lines 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 [][]\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 26678--26678 [][]\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 26678--26678 \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 26678--26678 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [443] LaTeX Warning: Hyper reference `FitsChan' on page 444 undefined on input line 2 6736. LaTeX Warning: Hyper reference `astRead' on page 444 undefined on input line 26 736. LaTeX Warning: Hyper reference `KeyMap' on page 444 undefined on input line 267 36. LaTeX Warning: Hyper reference `FitsTable' on page 444 undefined on input line 26736. Overfull \hbox (26.6159pt too wide) in paragraph at lines 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 444 undefined on input li ne 26736. Overfull \hbox (22.9418pt too wide) in paragraph at lines 26736--26736 [][]\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 444 undefined on input lin e 26736. Overfull \hbox (0.37231pt too wide) in paragraph at lines 26736--26736 [][]\T1/cmtt/m/n/10 The astPutTable method provides a simpler means of adding a single table to a [444] LaTeX Warning: Hyper reference `Mapping' on page 445 undefined on input line 26 851. Overfull \hbox (15.85886pt too wide) in paragraph at lines 26851--26851 []\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 445 undefined on input line 26851. Overfull \hbox (26.6159pt too wide) in paragraph at lines 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.37231pt too wide) in paragraph at lines 26851--26851 [] \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 26851--26851 \T1/cmtt/m/n/10 is at " lbnd[0]" and the last is at " ubnd[0]" . If a value les s than three is Overfull \hbox (5.62103pt too wide) in paragraph at lines 26851--26851 [] \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 26851--26851 \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 445 undefined on input line 26851 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 26851--26851 [] \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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 []\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 26851--26851 \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 26851--26851 \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 26851--26851 \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 445 undefined on input line 26851. Overfull \hbox (0.37231pt too wide) in paragraph at lines 26851--26851 [][]\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 26851--26851 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using astInvert before invoking [445] Overfull \hbox (26.35347pt too wide) in paragraph at lines 26851--26851 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [446] LaTeX Warning: Hyper reference `Mapping' on page 447 undefined on input line 26 920. Overfull \hbox (21.36719pt too wide) in paragraph at lines 26920--26920 [] \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 26920--26920 \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 26920--26920 \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 26920--26920 \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 26920--26920 \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 26920--26920 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [447] LaTeX Warning: Hyper reference `RateMap' on page 448 undefined on input line 27 020. LaTeX Warning: Hyper reference `Mapping' on page 448 undefined on input line 27 020. Overfull \hbox (4.4716pt too wide) in paragraph at lines 27020--27020 []\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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 \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 448 undefined on input line 270 20. Overfull \hbox (10.86975pt too wide) in paragraph at lines 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 [] \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 27020--27020 \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 27020--27020 \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 448 undefined on input line 27 020. Overfull \hbox (10.60732pt too wide) in paragraph at lines 27020--27020 [][]\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 27020--27020 \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 27020--27020 \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 27020--27020 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [448] LaTeX Warning: Hyper reference `Object' on page 449 undefined on input line 270 20. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27020--27020 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [449] LaTeX Warning: Hyper reference `Object' on page 450 undefined on input line 270 88. LaTeX Warning: Hyper reference `Channel' on page 450 undefined on input line 27 088. LaTeX Warning: Hyper reference `FitsChan' on page 450 undefined on input line 2 7088. LaTeX Warning: Hyper reference `astRetainFits' on page 450 undefined on input l ine 27088. Overfull \hbox (18.0096pt too wide) in paragraph at lines 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 450 undefined on input line 2 7088. LaTeX Warning: Hyper reference `Region' on page 450 undefined on input line 270 88. LaTeX Warning: Hyper reference `KeyMap' on page 450 undefined on input line 270 88. LaTeX Warning: Hyper reference `StcsArea' on page 450 undefined on input line 2 7088. LaTeX Warning: Hyper reference `StcsCoords' on page 450 undefined on input line 27088. LaTeX Warning: Hyper reference `StcsProps' on page 450 undefined on input line 27088. Overfull \hbox (17.74716pt too wide) in paragraph at lines 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 [][]\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 27088--27088 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [450] LaTeX Warning: Hyper reference `FitsChan' on page 451 undefined on input line 2 7130. Overfull \hbox (0.37231pt too wide) in paragraph at lines 27130--27130 [][]\T1/cmtt/m/n/10 This function returns without action if no source function was specified when LaTeX Warning: Hyper reference `SourceFile' on page 451 undefined on input line 27130. Overfull \hbox (5.62103pt too wide) in paragraph at lines 27130--27130 [][]\T1/cmtt/m/n/10 The SourceFile attribute is ignored by this function. New c ards are read from [451] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. LaTeX Warning: Hyper reference `Mapping' on page 452 undefined on input line 27 653. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 452 undefined on in put line 27653. Overfull \hbox (6.0526pt too wide) in paragraph at lines 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 > $ [452] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 \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 453 undefined on input line 27653. LaTeX Warning: Hyper reference `Nout' on page 453 undefined on input line 27653 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 [] \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [453] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 27653--27653 [] \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [454] Overfull \hbox (47.61078pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [455] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 456 undefined on in put line 27653. Overfull \hbox (41.17413pt too wide) in paragraph at lines 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 [][]\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [456] Overfull \hbox (10.86975pt too wide) in paragraph at lines 27653--27653 [][]\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [457] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 458 undefined on input line 28255. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 458 undefined on in put line 28255. Overfull \hbox (21.79875pt too wide) in paragraph at lines 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 458 undefined on input line 28 255. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 \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 458 undefined on input line 28255. LaTeX Warning: Hyper reference `Nout' on page 458 undefined on input line 28255 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [458] Overfull \hbox (5.3586pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [] \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [459] Overfull \hbox (16.11847pt too wide) in paragraph at lines 28255--28255 [] \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [460] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 [461] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [462] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 []\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 28255--28255 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [463] Overfull \hbox (7.51216pt too wide) in paragraph at lines 28255--28255 []\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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [464] LaTeX Warning: Hyper reference `Region' on page 465 undefined on input line 282 79. LaTeX Warning: Hyper reference `Plot' on page 465 undefined on input line 28279 . [465] LaTeX Warning: Hyper reference `Mapping' on page 466 undefined on input line 28 358. LaTeX Warning: Hyper reference `Frame' on page 466 undefined on input line 2835 8. LaTeX Warning: Hyper reference `FrameSet' on page 466 undefined on input line 2 8358. LaTeX Warning: Hyper reference `Nframe' on page 466 undefined on input line 283 58. Overfull \hbox (0.10988pt too wide) in paragraph at lines 28358--28358 \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 28358--28358 \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 28358--28358 \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 28358--28358 \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 28358--28358 [][]\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 28358--28358 [][]\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 28358--28358 \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 466 undefined on input line 28358. LaTeX Warning: Hyper reference `Nout' on page 466 undefined on input line 28358 . Overfull \hbox (20.31744pt too wide) in paragraph at lines 28358--28358 [][]\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 28358--28358 \T1/cmtt/m/n/10 and the number of output coordinate values generated (its Nout attribute) must LaTeX Warning: Hyper reference `astPermAxes' on page 466 undefined on input lin e 28358. Overfull \hbox (10.60732pt too wide) in paragraph at lines 28358--28358 [][]\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 28358--28358 \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 466 undefined on input lin e 28358. LaTeX Warning: Hyper reference `astRemoveFrame' on page 466 undefined on input line 28358. Overfull \hbox (23.99155pt too wide) in paragraph at lines 28358--28358 [][]\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 28358--28358 \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 466 undefined on input line 28 358. Overfull \hbox (10.86975pt too wide) in paragraph at lines 28358--28358 [][]\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 28358--28358 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [466] LaTeX Warning: Hyper reference `Table' on page 467 undefined on input line 2838 7. Overfull \hbox (17.43065pt too wide) in paragraph at lines 28387--28387 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [467] LaTeX Warning: Hyper reference `Frame' on page 468 undefined on input line 2844 6. LaTeX Warning: Hyper reference `FrameSet' on page 468 undefined on input line 2 8446. LaTeX Warning: Hyper reference `Nframe' on page 468 undefined on input line 284 46. Overfull \hbox (15.85603pt too wide) in paragraph at lines 28446--28446 \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 28446--28446 \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 28446--28446 [][]\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 28446--28446 \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 28446--28446 [][]\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 28446--28446 [][]\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 468 undefined on input line 28446 . LaTeX Warning: Hyper reference `Current' on page 468 undefined on input line 28 446. Overfull \hbox (16.11847pt too wide) in paragraph at lines 28446--28446 [][]\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 28446--28446 \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 28446--28446 [][]\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 28446--28446 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [468] LaTeX Warning: Hyper reference `Table' on page 469 undefined on input line 2847 5. Overfull \hbox (33.1768pt too wide) in paragraph at lines 28475--28475 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [469] LaTeX Warning: Hyper reference `Mapping' on page 470 undefined on input line 28 558. LaTeX Warning: Hyper reference `CmpMap' on page 470 undefined on input line 285 58. LaTeX Warning: Hyper reference `Region' on page 470 undefined on input line 285 58. LaTeX Warning: Hyper reference `UnitMap' on page 470 undefined on input line 28 558. LaTeX Warning: Hyper reference `CmpFrame' on page 470 undefined on input line 2 8558. LaTeX Warning: Hyper reference `Frame' on page 470 undefined on input line 2855 8. Overfull \hbox (18.27203pt too wide) in paragraph at lines 28558--28558 \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 470 undefined on input line 2 8558. Overfull \hbox (44.51563pt too wide) in paragraph at lines 28558--28558 \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 28558--28558 \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 28558--28558 \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 28558--28558 \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 470 undefined on input line 2 8558. Overfull \hbox (1.94693pt too wide) in paragraph at lines 28558--28558 [][]\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 28558--28558 \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 470 undefined on input line 28 558. Overfull \hbox (26.6159pt too wide) in paragraph at lines 28558--28558 [][]\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 28558--28558 \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 28558--28558 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 470 undefined on input line 285 58. Overfull \hbox (5.62103pt too wide) in paragraph at lines 28558--28558 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [470] LaTeX Warning: Hyper reference `Table' on page 471 undefined on input line 2858 6. [471] LaTeX Warning: Hyper reference `FitsChan' on page 472 undefined on input line 2 8614. Overfull \hbox (21.10475pt too wide) in paragraph at lines 28614--28614 \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 28614--28614 \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 28614--28614 [472] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. LaTeX Warning: Hyper reference `Mapping' on page 473 undefined on input line 29 462. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 473 undefined on input line 29462. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 473 undefined on in put line 29462. Overfull \hbox (3.69067pt too wide) in paragraph at lines 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [473] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 \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 29462--29462 \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 29462--29462 \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 474 undefined on input line 29462. LaTeX Warning: Hyper reference `Nout' on page 474 undefined on input line 29462 . Overfull \hbox (35.80116pt too wide) in paragraph at lines 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [] \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [474] Overfull \hbox (52.8595pt too wide) in paragraph at lines 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 [] \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [475] Overfull \hbox (5.3586pt too wide) in paragraph at lines 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [476] Overfull \hbox (26.35347pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [477] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [478] Overfull \hbox (56.1174pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [479] Overfull \hbox (21.36719pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 480 undefined on input line 29462. Overfull \hbox (47.61078pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 schemes described above). Other elements of the " params" array are available LaTeX Warning: Hyper reference `astUinterp' on page 480 undefined on input line 29462. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [480] Overfull \hbox (0.37231pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 []\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [481] Overfull \hbox (26.6159pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [482] Overfull \hbox (12.97206pt too wide) in paragraph at lines 29544--29544 []\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 483 undefined on input line 2954 4. LaTeX Warning: Hyper reference `Naxes' on page 483 undefined on input line 2954 4. Overfull \hbox (21.10475pt too wide) in paragraph at lines 29544--29544 \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 29544--29544 \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 29544--29544 \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 29544--29544 \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 29544--29544 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29544--29544 [] \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 29544--29544 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.86975pt too wide) in paragraph at lines 29544--29544 [] \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 29544--29544 \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 483 undefined on input lin e 29544. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29544--29544 [][]\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 29544--29544 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [483] LaTeX Warning: Hyper reference `FitsChan' on page 484 undefined on input line 2 9585. LaTeX Warning: Hyper reference `Object' on page 484 undefined on input line 295 85. LaTeX Warning: Hyper reference `astRead' on page 484 undefined on input line 29 585. LaTeX Warning: Hyper reference `Card' on page 484 undefined on input line 29585 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 29585--29585 [][]\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 29585--29585 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the Card attribute exceeds the numb er of cards in [484] LaTeX Warning: Hyper reference `Object' on page 485 undefined on input line 296 36. Overfull \hbox (16.11847pt too wide) in paragraph at lines 29636--29636 [][]\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 29636--29636 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [485] LaTeX Warning: Hyper reference `SelectorMap' on page 486 undefined on input lin e 29737. LaTeX Warning: Hyper reference `Mapping' on page 486 undefined on input line 29 737. LaTeX Warning: Hyper reference `Region' on page 486 undefined on input line 297 37. LaTeX Warning: Hyper reference `Frame' on page 486 undefined on input line 2973 7. LaTeX Warning: Hyper reference `Nin' on page 486 undefined on input line 29737. LaTeX Warning: Hyper reference `UnitMap' on page 486 undefined on input line 29 737. LaTeX Warning: Hyper reference `astSimplify' on page 486 undefined on input lin e 29737. Overfull \hbox (23.41824pt too wide) in paragraph at lines 29737--29737 []\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 29737--29737 \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 29737--29737 \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 29737--29737 \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 486 undefined on input line 297 37. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29737--29737 \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 29737--29737 \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 29737--29737 \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 29737--29737 [] \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 29737--29737 \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 29737--29737 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [486] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29737--29737 [][]\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 29737--29737 \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 487 undefined on input line 297 37. Overfull \hbox (5.62103pt too wide) in paragraph at lines 29737--29737 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [487] LaTeX Warning: Hyper reference `Object' on page 488 undefined on input line 298 43. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29843--29843 \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 29843--29843 [] \T1/cmtt/m/n/10 Optional additional arguments which supply values to be s ubstituted for any " LaTeX Warning: Hyper reference `Report' on page 488 undefined on input line 298 43. LaTeX Warning: Hyper reference `Zoom' on page 488 undefined on input line 29843 . Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 488 undefined on input lin e 29843. Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 488 undefined on input line 2984 3. Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 29843--29843 [][]\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 29843--29843 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [488] Overfull \hbox (42.36206pt too wide) in paragraph at lines 29843--29843 [][]\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 29843--29843 \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 29843--29843 \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 29843--29843 [][]\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 29843--29843 \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 29843--29843 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [489] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. LaTeX Warning: Hyper reference `Object' on page 490 undefined on input line 299 15. Overfull \hbox (26.6159pt too wide) in paragraph at lines 29915--29915 \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 29915--29915 \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 29915--29915 \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 29915--29915 Underfull \hbox (badness 10000) in paragraph at lines 29915--29915 Underfull \hbox (badness 10000) in paragraph at lines 29915--29915 [] \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 29915--29915 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [490] LaTeX Warning: Hyper reference `Frame' on page 491 undefined on input line 3004 1. LaTeX Warning: Hyper reference `astFindFrame' on page 491 undefined on input li ne 30041. LaTeX Warning: Hyper reference `astConvert' on page 491 undefined on input line 30041. LaTeX Warning: Hyper reference `Mapping' on page 491 undefined on input line 30 041. LaTeX Warning: Hyper reference `FrameSet' on page 491 undefined on input line 3 0041. LaTeX Warning: Hyper reference `ZoomMap' on page 491 undefined on input line 30 041. LaTeX Warning: Hyper reference `Axis' on page 491 undefined on input line 30041 . LaTeX Warning: Hyper reference `SkyFrame' on page 491 undefined on input line 3 0041. Overfull \hbox (23.25832pt too wide) in paragraph at lines 30041--30041 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [491] LaTeX Warning: Hyper reference `SpecFrame' on page 492 undefined on input line 30041. Overfull \hbox (28.50703pt too wide) in paragraph at lines 30041--30041 \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 492 undefined on input line 30041. Overfull \hbox (28.50703pt too wide) in paragraph at lines 30041--30041 \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 492 undefined on input line 3 0041. Overfull \hbox (7.51216pt too wide) in paragraph at lines 30041--30041 \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 30041--30041 \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 30041--30041 \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 30041--30041 \T1/cmtt/m/n/10 through all references to the component Frames, not just those encapsulated within LaTeX Warning: Hyper reference `Region' on page 492 undefined on input line 300 41. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 492 undefined on input l ine 30041. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 492 undefined on input l ine 30041. Overfull \hbox (16.11847pt too wide) in paragraph at lines 30041--30041 [][]\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 30041--30041 \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 492 undefined on inpu t line 30041. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30041--30041 [][]\T1/cmtt/m/n/10 The astGetActiveUnit function can be used to retrieve the c urrent value of the [492] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. LaTeX Warning: Hyper reference `FitsChan' on page 493 undefined on input line 3 0191. Overfull \hbox (14.82803pt too wide) in paragraph at lines 30191--30191 []\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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [493] LaTeX Warning: Hyper reference `Card' on page 494 undefined on input line 30191 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 494 undefined on input lin e 30191. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30191--30191 [][]\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 494 undefined on input li ne 30191. Overfull \hbox (16.11847pt too wide) in paragraph at lines 30191--30191 [][]\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 494 undefined on input lin e 30191. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30191--30191 [][]\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 30191--30191 \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 30191--30191 [][]\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 30191--30191 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [494] LaTeX Warning: Hyper reference `FitsChan' on page 495 undefined on input line 3 0245. Overfull \hbox (10.60732pt too wide) in paragraph at lines 30245--30245 \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 30245--30245 \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 495 undefined on input line 30245 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [495] LaTeX Warning: Hyper reference `FitsChan' on page 496 undefined on input line 3 0317. Overfull \hbox (39.63802pt too wide) in paragraph at lines 30317--30317 []\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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 496 undefined on input line 30317 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 [][]\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 30317--30317 [][]\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 `ast_link' on page 497 undefined on input line 3 0369. Overfull \hbox (5.3586pt too wide) in paragraph at lines 30369--30369 \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 30369--30369 \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 30369--30369 \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 30369--30369 []\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 30369--30369 \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 30369--30369 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [497] LaTeX Warning: Hyper reference `RefRA' on page 498 undefined on input line 3041 3. LaTeX Warning: Hyper reference `RefDec' on page 498 undefined on input line 304 13. LaTeX Warning: Hyper reference `SkyFrame' on page 498 undefined on input line 3 0413. LaTeX Warning: Hyper reference `SpecFrame' on page 498 undefined on input line 30413. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30413--30413 \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 30413--30413 \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 30413--30413 \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 30413--30413 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 30413--30413 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [498] LaTeX Warning: Hyper reference `astChannel' on page 499 undefined on input line 30451. LaTeX Warning: Hyper reference `astFitsChan' on page 499 undefined on input lin e 30451. LaTeX Warning: Hyper reference `astClearStatus' on page 499 undefined on input line 30451. Overfull \hbox (0.37231pt too wide) in paragraph at lines 30451--30451 [][]\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 30451--30451 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [499] LaTeX Warning: Hyper reference `Region' on page 500 undefined on input line 304 93. LaTeX Warning: Hyper reference `Box' on page 500 undefined on input line 30493. LaTeX Warning: Hyper reference `Circle' on page 500 undefined on input line 304 93. LaTeX Warning: Hyper reference `Ellipse' on page 500 undefined on input line 30 493. LaTeX Warning: Hyper reference `Prism' on page 500 undefined on input line 3049 3. Overfull \hbox (0.37231pt too wide) in paragraph at lines 30493--30493 \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 30493--30493 \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 30493--30493 \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 30493--30493 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [500] LaTeX Warning: Hyper reference `ShiftMap' on page 501 undefined on input line 3 0570. LaTeX Warning: Hyper reference `Mapping' on page 501 undefined on input line 30 570. Overfull \hbox (9.50914pt too wide) in paragraph at lines 30570--30570 []\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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 \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 501 undefined on input line 305 70. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 [] \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 30570--30570 \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 30570--30570 \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 501 undefined on input line 305 70. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30570--30570 [][]\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 30570--30570 []\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 30570--30570 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [501] LaTeX Warning: Hyper reference `Object' on page 502 undefined on input line 305 98. [502] LaTeX Warning: Hyper reference `FitsChan' on page 503 undefined on input line 3 0618. [503] LaTeX Warning: Hyper reference `Region' on page 504 undefined on input line 306 58. LaTeX Warning: Hyper reference `Frame' on page 504 undefined on input line 3065 8. LaTeX Warning: Hyper reference `MeshSize' on page 504 undefined on input line 3 0658. Overfull \hbox (42.09962pt too wide) in paragraph at lines 30658--30658 \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 30658--30658 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [504] LaTeX Warning: Hyper reference `Mapping' on page 505 undefined on input line 30 741. LaTeX Warning: Hyper reference `CmpMap' on page 505 undefined on input line 307 41. LaTeX Warning: Hyper reference `FrameSet' on page 505 undefined on input line 3 0741. LaTeX Warning: Hyper reference `Frame' on page 505 undefined on input line 3074 1. Overfull \hbox (44.51563pt too wide) in paragraph at lines 30741--30741 \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 505 undefined on input line 3074 1. Overfull \hbox (21.10475pt too wide) in paragraph at lines 30741--30741 [][]\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 30741--30741 \T1/cmtt/m/n/10 simplification. This is so that their individual identity is pr eserved. This LaTeX Warning: Hyper reference `astClone' on page 505 undefined on input line 3 0741. Overfull \hbox (12.44437pt too wide) in paragraph at lines 30741--30741 [][]\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 30741--30741 \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 505 undefined on input line 30 741. Overfull \hbox (26.6159pt too wide) in paragraph at lines 30741--30741 [][]\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 30741--30741 \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 30741--30741 \T1/cmtt/m/n/10 modification of the original. If a completely independent resul t is required, LaTeX Warning: Hyper reference `Object' on page 505 undefined on input line 307 41. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30741--30741 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [505] LaTeX Warning: Hyper reference `SkyFrame' on page 506 undefined on input line 3 0870. LaTeX Warning: Hyper reference `Frame' on page 506 undefined on input line 3087 0. LaTeX Warning: Hyper reference `System' on page 506 undefined on input line 308 70. LaTeX Warning: Hyper reference `Equinox' on page 506 undefined on input line 30 870. LaTeX Warning: Hyper reference `Epoch' on page 506 undefined on input line 3087 0. LaTeX Warning: Hyper reference `SkyRefIs' on page 506 undefined on input line 3 0870. LaTeX Warning: Hyper reference `astFormat' on page 506 undefined on input line 30870. LaTeX Warning: Hyper reference `astSet' on page 506 undefined on input line 308 70. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 [] \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 30870--30870 \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 30870--30870 \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 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \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 30870--30870 \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 30870--30870 \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 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \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 30870--30870 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [506] Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 \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 30870--30870 [][]\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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 507 undefined on input lin e 30870. Overfull \hbox (21.36719pt too wide) in paragraph at lines 30870--30870 [][]\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 30870--30870 \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 507 undefined on input line 30870. LaTeX Warning: Hyper reference `AlignSystem' on page 507 undefined on input lin e 30870. Overfull \hbox (10.86975pt too wide) in paragraph at lines 30870--30870 [][]\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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \T1/cmtt/m/n/10 will therefore fully reflect the relationship between positions on the sky measured LaTeX Warning: Hyper reference `Object' on page 507 undefined on input line 308 70. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30870--30870 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [507] LaTeX Warning: Hyper reference `Mapping' on page 508 undefined on input line 30 913. LaTeX Warning: Hyper reference `System' on page 508 undefined on input line 309 13. LaTeX Warning: Hyper reference `SkyFrame' on page 508 undefined on input line 3 0913. LaTeX Warning: Hyper reference `SkyRefIs' on page 508 undefined on input line 3 0913. LaTeX Warning: Hyper reference `UnitMap' on page 508 undefined on input line 30 913. LaTeX Warning: Hyper reference `Object' on page 508 undefined on input line 309 13. Overfull \hbox (5.62103pt too wide) in paragraph at lines 30913--30913 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [508] LaTeX Warning: Hyper reference `SlaMap' on page 509 undefined on input line 311 33. LaTeX Warning: Hyper reference `astSlaMap' on page 509 undefined on input line 31133. LaTeX Warning: Hyper reference `Mapping' on page 509 undefined on input line 31 133. LaTeX Warning: Hyper reference `Invert' on page 509 undefined on input line 311 33. Overfull \hbox (0.37231pt too wide) in paragraph at lines 31133--31133 [] \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 \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 509 undefined on input lin e 31133. Overfull \hbox (37.11334pt too wide) in paragraph at lines 31133--31133 [][]\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [509] Overfull \hbox (49.23947pt too wide) in paragraph at lines 31133--31133 []\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 []\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 [][]\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 31133--31133 [][]\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 31133--31133 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [510] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31133--31133 \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 31133--31133 \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 31133--31133 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [511] LaTeX Warning: Hyper reference `SlaMap' on page 512 undefined on input line 312 13. LaTeX Warning: Hyper reference `Mapping' on page 512 undefined on input line 31 213. LaTeX Warning: Hyper reference `astSlaAdd' on page 512 undefined on input line 31213. Overfull \hbox (10.60732pt too wide) in paragraph at lines 31213--31213 \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 512 undefined on input line 312 13. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31213--31213 \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 31213--31213 \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 31213--31213 \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 31213--31213 \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 31213--31213 [] \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 31213--31213 \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 31213--31213 \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 512 undefined on input line 31213. LaTeX Warning: Hyper reference `Nout' on page 512 undefined on input line 31213 . Overfull \hbox (26.6159pt too wide) in paragraph at lines 31213--31213 [][]\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 31213--31213 \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 31213--31213 \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 512 undefined on input line 312 13. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31213--31213 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [512] LaTeX Warning: Hyper reference `SpecMap' on page 513 undefined on input line 31 494. LaTeX Warning: Hyper reference `astSpecMap' on page 513 undefined on input line 31494. LaTeX Warning: Hyper reference `Mapping' on page 513 undefined on input line 31 494. LaTeX Warning: Hyper reference `Invert' on page 513 undefined on input line 314 94. Overfull \hbox (6.88478pt too wide) in paragraph at lines 31494--31494 []\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 31494--31494 [] \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 LaTeX Warning: Hyper reference `astSimplify' on page 513 undefined on input lin e 31494. Overfull \hbox (37.11334pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 [][]\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 31494--31494 []\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 31494--31494 \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 31494--31494 \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 31494--31494 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [513] Overfull \hbox (5.62103pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [514] Overfull \hbox (33.43924pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 515 undefined on input line 3149 4. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [515] LaTeX Warning: Hyper reference `SpecFluxFrame' on page 516 undefined on input l ine 31579. LaTeX Warning: Hyper reference `SpecFrame' on page 516 undefined on input line 31579. LaTeX Warning: Hyper reference `FluxFrame' on page 516 undefined on input line 31579. LaTeX Warning: Hyper reference `Frame' on page 516 undefined on input line 3157 9. LaTeX Warning: Hyper reference `Plot' on page 516 undefined on input line 31579 . Overfull \hbox (18.64314pt too wide) in paragraph at lines 31579--31579 []\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 31579--31579 \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 516 undefined on input line 31 579. Overfull \hbox (28.19052pt too wide) in paragraph at lines 31579--31579 \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 31579--31579 \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 516 undefined on input line 315 79. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31579--31579 \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 31579--31579 \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 31579--31579 \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 31579--31579 [] \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 31579--31579 \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 31579--31579 \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 31579--31579 [][]\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 31579--31579 \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 31579--31579 \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 516 undefined on input line 315 79. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31579--31579 [][]\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 31579--31579 []\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 31579--31579 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [516] LaTeX Warning: Hyper reference `SpecFrame' on page 517 undefined on input line 31679. LaTeX Warning: Hyper reference `Frame' on page 517 undefined on input line 3167 9. LaTeX Warning: Hyper reference `System' on page 517 undefined on input line 316 79. LaTeX Warning: Hyper reference `SpecOrigin' on page 517 undefined on input line 31679. LaTeX Warning: Hyper reference `astSet' on page 517 undefined on input line 316 79. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 [] \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 31679--31679 \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 31679--31679 \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 517 undefined on input line 3 1679. Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 \T1/cmtt/m/n/10 system. The RestFreq attribute (rest frequency) is unspecified, so it will Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 517 undefined on input line 31679. LaTeX Warning: Hyper reference `RefRA' on page 517 undefined on input line 3167 9. LaTeX Warning: Hyper reference `RefDec' on page 517 undefined on input line 316 79. Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [517] LaTeX Warning: Hyper reference `astConvert' on page 518 undefined on input line 31679. LaTeX Warning: Hyper reference `AlignSystem' on page 518 undefined on input lin e 31679. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 518 undefined on input line 31679. Overfull \hbox (21.36719pt too wide) in paragraph at lines 31679--31679 [][]\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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \T1/cmtt/m/n/10 between positions measured in the two systems. In addition, any difference in LaTeX Warning: Hyper reference `Object' on page 518 undefined on input line 316 79. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31679--31679 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [518] LaTeX Warning: Hyper reference `SpecMap' on page 519 undefined on input line 31 795. LaTeX Warning: Hyper reference `Mapping' on page 519 undefined on input line 31 795. LaTeX Warning: Hyper reference `astSpecAdd' on page 519 undefined on input line 31795. Overfull \hbox (17.43065pt too wide) in paragraph at lines 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 519 undefined on input line 317 95. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 [] \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 31795--31795 \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 31795--31795 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [519] Overfull \hbox (12.44437pt too wide) in paragraph at lines 31795--31795 [][]\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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 520 undefined on input line 317 95. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31795--31795 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [520] LaTeX Warning: Hyper reference `SphMap' on page 521 undefined on input line 318 93. LaTeX Warning: Hyper reference `Mapping' on page 521 undefined on input line 31 893. LaTeX Warning: Hyper reference `astSet' on page 521 undefined on input line 318 93. Overfull \hbox (10.86975pt too wide) in paragraph at lines 31893--31893 \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 31893--31893 \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 31893--31893 \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 31893--31893 [] \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 31893--31893 \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 31893--31893 \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 31893--31893 [][]\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 31893--31893 \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 31893--31893 \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 521 undefined on input line 31893. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31893--31893 [][]\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 521 undefined on input line 318 93. Overfull \hbox (5.62103pt too wide) in paragraph at lines 31893--31893 [][]\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 31893--31893 []\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 31893--31893 \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 31893--31893 []\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 31893--31893 \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 31893--31893 []\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 31893--31893 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [521] [522] LaTeX Warning: Hyper reference `astClearStatus' on page 523 undefined on input line 31922. Overfull \hbox (42.36206pt too wide) in paragraph at lines 31922--31922 [][]\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 31922--31922 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [523] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 524 undefined on input line 32012. LaTeX Warning: Hyper reference `Stc' on page 524 undefined on input line 32012. Overfull \hbox (26.30504pt too wide) in paragraph at lines 32012--32012 []\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 524 undefined on input line 320 12. LaTeX Warning: Hyper reference `KeyMap' on page 524 undefined on input line 320 12. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \T1/cmtt/m/n/10 information (error, resolution, size, pixel size or value). The se Regions should LaTeX Warning: Hyper reference `astSet' on page 524 undefined on input line 320 12. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 [] \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 32012--32012 \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 32012--32012 \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 32012--32012 [][]\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 32012--32012 \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 524 undefined on input line 320 12. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32012--32012 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [524] [525] LaTeX Warning: Hyper reference `StcObsDataLocation' on page 526 undefined on in put line 32102. LaTeX Warning: Hyper reference `Stc' on page 526 undefined on input line 32102. Overfull \hbox (28.9294pt too wide) in paragraph at lines 32102--32102 []\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 526 undefined on input line 321 02. LaTeX Warning: Hyper reference `KeyMap' on page 526 undefined on input line 321 02. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 02. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 [] \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 32102--32102 \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 32102--32102 \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 32102--32102 [][]\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 32102--32102 \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 02. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32102--32102 [][]\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 `StcResourceProfile' on page 528 undefined on in put line 32200. LaTeX Warning: Hyper reference `Stc' on page 528 undefined on input line 32200. Overfull \hbox (28.9294pt too wide) in paragraph at lines 32200--32200 []\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 528 undefined on input line 322 00. LaTeX Warning: Hyper reference `KeyMap' on page 528 undefined on input line 322 00. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 00. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 [] \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 32200--32200 \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 32200--32200 \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 32200--32200 [][]\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 32200--32200 \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 00. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32200--32200 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [528] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32200--32200 []\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 32200--32200 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [529] LaTeX Warning: Hyper reference `StcSearchLocation' on page 530 undefined on inp ut line 32298. LaTeX Warning: Hyper reference `Stc' on page 530 undefined on input line 32298. Overfull \hbox (23.68068pt too wide) in paragraph at lines 32298--32298 []\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 530 undefined on input line 322 98. LaTeX Warning: Hyper reference `KeyMap' on page 530 undefined on input line 322 98. Overfull \hbox (18.74283pt too wide) in paragraph at lines 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 322 98. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 [] \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 32298--32298 \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 32298--32298 \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 32298--32298 [][]\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 32298--32298 \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 322 98. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32298--32298 [][]\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 32298--32298 []\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 32298--32298 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] LaTeX Warning: Hyper reference `StcsChan' on page 532 undefined on input line 3 2401. LaTeX Warning: Hyper reference `Channel' on page 532 undefined on input line 32 401. LaTeX Warning: Hyper reference `Object' on page 532 undefined on input line 324 01. LaTeX Warning: Hyper reference `astWrite' on page 532 undefined on input line 3 2401. LaTeX Warning: Hyper reference `XmlChan' on page 532 undefined on input line 32 401. LaTeX Warning: Hyper reference `SinkFile' on page 532 undefined on input line 3 2401. LaTeX Warning: Hyper reference `SourceFile' on page 532 undefined on input line 32401. Overfull \hbox (8.09445pt too wide) in paragraph at lines 32401--32401 []\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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 []\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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 []\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 532 undefined on input line 324 01. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 [] \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 32401--32401 \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 32401--32401 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [532] Overfull \hbox (8.24539pt too wide) in paragraph at lines 32401--32401 [][]\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 32401--32401 \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 32401--32401 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [533] LaTeX Warning: Hyper reference `astEscapes' on page 534 undefined on input line 32442. LaTeX Warning: Hyper reference `Plot' on page 534 undefined on input line 32442 . LaTeX Warning: Hyper reference `Escape' on page 534 undefined on input line 324 42. Overfull \hbox (2.52588pt too wide) in paragraph at lines 32442--32442 \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 32442--32442 \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 32442--32442 \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 32442--32442 \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 32442--32442 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [534] LaTeX Warning: Hyper reference `SwitchMap' on page 535 undefined on input line 32601. LaTeX Warning: Hyper reference `Mapping' on page 535 undefined on input line 32 601. LaTeX Warning: Hyper reference `Nin' on page 535 undefined on input line 32601. LaTeX Warning: Hyper reference `Nout' on page 535 undefined on input line 32601 . LaTeX Warning: Hyper reference `SelectorMap' on page 535 undefined on input lin e 32601. LaTeX Warning: Hyper reference `UnitMap' on page 535 undefined on input line 32 601. LaTeX Warning: Hyper reference `astSimplify' on page 535 undefined on input lin e 32601. Overfull \hbox (34.3893pt too wide) in paragraph at lines 32601--32601 []\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 [535] Overfull \hbox (65.9813pt too wide) in paragraph at lines 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 536 undefined on input line 326 01. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 [] \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 32601--32601 \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 32601--32601 \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 536 undefined on input line 32 601. Overfull \hbox (0.37231pt too wide) in paragraph at lines 32601--32601 [][]\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 32601--32601 \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 32601--32601 \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 32601--32601 \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 536 undefined on input line 326 01. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32601--32601 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [536] LaTeX Warning: Hyper reference `Table' on page 537 undefined on input line 3269 1. LaTeX Warning: Hyper reference `KeyMap' on page 537 undefined on input line 326 91. LaTeX Warning: Hyper reference `astAddColumn' on page 537 undefined on input li ne 32691. LaTeX Warning: Hyper reference `astAddParameter' on page 537 undefined on input line 32691. LaTeX Warning: Hyper reference `astSet' on page 537 undefined on input line 326 91. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32691--32691 \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 32691--32691 \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 32691--32691 \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 32691--32691 [] \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 32691--32691 \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 32691--32691 \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 537 undefined on input line 326 91. Overfull \hbox (5.62103pt too wide) in paragraph at lines 32691--32691 [][]\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 32691--32691 []\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 32691--32691 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [537] LaTeX Warning: Hyper reference `FitsChan' on page 538 undefined on input line 3 2771. LaTeX Warning: Hyper reference `astRead' on page 538 undefined on input line 32 771. LaTeX Warning: Hyper reference `FrameSet' on page 538 undefined on input line 3 2771. LaTeX Warning: Hyper reference `TabOK' on page 538 undefined on input line 3277 1. LaTeX Warning: Hyper reference `astPutTables' on page 538 undefined on input li ne 32771. LaTeX Warning: Hyper reference `astPutTable' on page 538 undefined on input lin e 32771. Overfull \hbox (18.3807pt too wide) in paragraph at lines 32771--32771 []\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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 538 undefined on input line 32771. Overfull \hbox (31.60219pt too wide) in paragraph at lines 32771--32771 []\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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 []\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 538 undefined on inp ut line 32771. LaTeX Warning: Hyper reference `astChannelData' on page 538 undefined on input line 32771. Overfull \hbox (10.86975pt too wide) in paragraph at lines 32771--32771 [][]\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 32771--32771 \T1/cmtt/m/n/10 table source function using the astPutChannelData function. The source function [538] LaTeX Warning: Hyper reference `Object' on page 539 undefined on input line 328 29. Overfull \hbox (26.6159pt too wide) in paragraph at lines 32829--32829 \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 32829--32829 \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 32829--32829 [][]\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 32829--32829 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [539] LaTeX Warning: Hyper reference `Moc' on page 540 undefined on input line 32880. LaTeX Warning: Hyper reference `MaxOrder' on page 540 undefined on input line 3 2880. Overfull \hbox (10.60732pt too wide) in paragraph at lines 32880--32880 \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 32880--32880 \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 32880--32880 \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 32880--32880 \T1/cmtt/m/n/10 One if the specified cell is included in the Moc at the specifi ed order, of (if " parent" [540] LaTeX Warning: Hyper reference `FitsChan' on page 541 undefined on input line 3 2960. Overfull \hbox (7.19565pt too wide) in paragraph at lines 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 [][]\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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 [][]\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 32960--32960 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [541] LaTeX Warning: Hyper reference `Plot' on page 542 undefined on input line 33049 . Overfull \hbox (10.55888pt too wide) in paragraph at lines 33049--33049 []\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 33049--33049 \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 33049--33049 \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 542 undefined on input line 330 49. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33049--33049 [] \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 []\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 33049--33049 [][]\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 33049--33049 [][]\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 33049--33049 \T1/cmtt/m/n/10 (or where the transformation into graphical coordinates yields coordinates containing LaTeX Warning: Hyper reference `astClip' on page 542 undefined on input line 33 049. LaTeX Warning: Hyper reference `Frame' on page 542 undefined on input line 3304 9. Overfull \hbox (0.37231pt too wide) in paragraph at lines 33049--33049 [][]\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 542 undefined on input lin e 33049. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33049--33049 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [542] LaTeX Warning: Hyper reference `Object' on page 543 undefined on input line 331 43. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33143--33143 [] \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 543 undefined on input line 33143. LaTeX Warning: Hyper reference `astLock' on page 543 undefined on input line 33 143. Overfull \hbox (18.0096pt too wide) in paragraph at lines 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 [][]\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 33143--33143 \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 33143--33143 [][]\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 33143--33143 \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 543 undefined on input line 3 3143. Overfull \hbox (7.51216pt too wide) in paragraph at lines 33143--33143 []\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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 543 undefined on input line 3 3143. Overfull \hbox (28.76947pt too wide) in paragraph at lines 33143--33143 []\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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 543 undefined on input line 331 43. Overfull \hbox (44.25319pt too wide) in paragraph at lines 33143--33143 []\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 33143--33143 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [543] Overfull \hbox (28.76947pt too wide) in paragraph at lines 33143--33143 []\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 33143--33143 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [544] LaTeX Warning: Hyper reference `TimeMap' on page 545 undefined on input line 33 383. LaTeX Warning: Hyper reference `astTimeMap' on page 545 undefined on input line 33383. LaTeX Warning: Hyper reference `Mapping' on page 545 undefined on input line 33 383. LaTeX Warning: Hyper reference `Invert' on page 545 undefined on input line 333 83. Overfull \hbox (6.88478pt too wide) in paragraph at lines 33383--33383 []\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 33383--33383 [] \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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 \T1/cmtt/m/n/10 the conversion specified (see the " Available Conversions" sect ion). This array LaTeX Warning: Hyper reference `astSimplify' on page 545 undefined on input lin e 33383. Overfull \hbox (37.11334pt too wide) in paragraph at lines 33383--33383 [][]\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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 [][]\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 33383--33383 []\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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [545] Overfull \hbox (33.75575pt too wide) in paragraph at lines 33383--33383 \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 33383--33383 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [546] Overfull \hbox (43.93668pt too wide) in paragraph at lines 33383--33383 [][]\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 33383--33383 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [547] LaTeX Warning: Hyper reference `TimeFrame' on page 548 undefined on input line 33473. LaTeX Warning: Hyper reference `Frame' on page 548 undefined on input line 3347 3. LaTeX Warning: Hyper reference `System' on page 548 undefined on input line 334 73. LaTeX Warning: Hyper reference `TimeOrigin' on page 548 undefined on input line 33473. LaTeX Warning: Hyper reference `TimeScale' on page 548 undefined on input line 33473. LaTeX Warning: Hyper reference `astSet' on page 548 undefined on input line 334 73. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33473--33473 \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 33473--33473 \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 33473--33473 \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 33473--33473 \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 33473--33473 [] \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 33473--33473 \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 33473--33473 \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 548 undefined on input line 33473. LaTeX Warning: Hyper reference `AlignSystem' on page 548 undefined on input lin e 33473. LaTeX Warning: Hyper reference `AlignTimeScale' on page 548 undefined on input line 33473. Overfull \hbox (21.36719pt too wide) in paragraph at lines 33473--33473 [][]\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 33473--33473 \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 33473--33473 \T1/cmtt/m/n/10 they represent, together with any qualifying time scale, offset , unit, etc. The LaTeX Warning: Hyper reference `Object' on page 548 undefined on input line 334 73. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33473--33473 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [548] [549] LaTeX Warning: Hyper reference `TimeMap' on page 550 undefined on input line 33 555. LaTeX Warning: Hyper reference `Mapping' on page 550 undefined on input line 33 555. LaTeX Warning: Hyper reference `astTimeAdd' on page 550 undefined on input line 33555. Overfull \hbox (10.60732pt too wide) in paragraph at lines 33555--33555 \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 550 undefined on input line 335 55. Overfull \hbox (10.86975pt too wide) in paragraph at lines 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 [] \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 33555--33555 \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 33555--33555 \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 33555--33555 [][]\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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 550 undefined on input line 335 55. Overfull \hbox (5.62103pt too wide) in paragraph at lines 33555--33555 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [550] LaTeX Warning: Hyper reference `Object' on page 551 undefined on input line 335 85. LaTeX Warning: Hyper reference `astFromString' on page 551 undefined on input l ine 33585. LaTeX Warning: Hyper reference `astFree' on page 551 undefined on input line 33 585. Overfull \hbox (23.25832pt too wide) in paragraph at lines 33585--33585 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [551] LaTeX Warning: Hyper reference `Mapping' on page 552 undefined on input line 33 653. Overfull \hbox (12.97206pt too wide) in paragraph at lines 33653--33653 []\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 33653--33653 \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 33653--33653 \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 33653--33653 \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 552 undefined on input line 33653. LaTeX Warning: Hyper reference `Nout' on page 552 undefined on input line 33653 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 33653--33653 [][]\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 33653--33653 []\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 33653--33653 \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 33653--33653 \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 33653--33653 \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 33653--33653 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [552] LaTeX Warning: Hyper reference `Mapping' on page 553 undefined on input line 33 734. Overfull \hbox (10.3477pt too wide) in paragraph at lines 33734--33734 []\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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 553 undefined on input line 33734. LaTeX Warning: Hyper reference `Nout' on page 553 undefined on input line 33734 . Overfull \hbox (12.44437pt too wide) in paragraph at lines 33734--33734 [][]\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 33734--33734 []\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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [553] LaTeX Warning: Hyper reference `Mapping' on page 554 undefined on input line 33 906. Overfull \hbox (20.84514pt too wide) in paragraph at lines 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (16.11847pt too wide) in paragraph at lines 33906--33906 [] \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [554] Overfull \hbox (42.09962pt too wide) in paragraph at lines 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 555 undefined on input line 33906. LaTeX Warning: Hyper reference `Nout' on page 555 undefined on input line 33906 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 33906--33906 [][]\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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \T1/cmtt/m/n/10 name is changed by appending the digit " 8" to the name. Thus, astTranGrid becomes [555] LaTeX Warning: Hyper reference `TranMap' on page 556 undefined on input line 34 008. LaTeX Warning: Hyper reference `Mapping' on page 556 undefined on input line 34 008. Overfull \hbox (9.9315pt too wide) in paragraph at lines 34008--34008 []\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 34008--34008 \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 34008--34008 \T1/cmtt/m/n/10 Pointer to the second component Mapping, which defines the inve rse transformation. LaTeX Warning: Hyper reference `astSet' on page 556 undefined on input line 340 08. Overfull \hbox (10.86975pt too wide) in paragraph at lines 34008--34008 \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 34008--34008 \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 34008--34008 \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 34008--34008 [] \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 34008--34008 \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 34008--34008 \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 556 undefined on input line 34008 . LaTeX Warning: Hyper reference `Nin' on page 556 undefined on input line 34008. Overfull \hbox (41.31232pt too wide) in paragraph at lines 34008--34008 [][]\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 34008--34008 \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 556 undefined on input line 34 008. Overfull \hbox (10.60732pt too wide) in paragraph at lines 34008--34008 [][]\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 34008--34008 \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 34008--34008 \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 34008--34008 \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 556 undefined on input line 340 08. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34008--34008 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [556] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34008--34008 []\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 34008--34008 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [557] LaTeX Warning: Hyper reference `Mapping' on page 558 undefined on input line 34 128. LaTeX Warning: Hyper reference `astTranP' on page 558 undefined on input line 3 4128. Overfull \hbox (7.72334pt too wide) in paragraph at lines 34128--34128 []\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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (58.10822pt too wide) in paragraph at lines 34128--34128 [] \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [558] LaTeX Warning: Hyper reference `Nin' on page 559 undefined on input line 34128. LaTeX Warning: Hyper reference `Nout' on page 559 undefined on input line 34128 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 34128--34128 [][]\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 34128--34128 \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 34128--34128 \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 34128--34128 []\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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 [559] LaTeX Warning: Hyper reference `Mapping' on page 560 undefined on input line 34 234. LaTeX Warning: Hyper reference `astTranN' on page 560 undefined on input line 3 4234. Overfull \hbox (5.31017pt too wide) in paragraph at lines 34234--34234 []\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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 560 undefined on input line 34234. LaTeX Warning: Hyper reference `Nout' on page 560 undefined on input line 34234 . Overfull \hbox (10.86975pt too wide) in paragraph at lines 34234--34234 [][]\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 34234--34234 \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 34234--34234 \T1/cmtt/m/n/10 for its Nout attribute. If the inverse transformation is being applied, these [560] Overfull \hbox (49.76434pt too wide) in paragraph at lines 34234--34234 []\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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [561] LaTeX Warning: Hyper reference `astTuneC' on page 562 undefined on input line 3 4316. Overfull \hbox (0.10988pt too wide) in paragraph at lines 34316--34316 \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 34316--34316 \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 34316--34316 [][]\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 34316--34316 \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 34316--34316 LaTeX Warning: Hyper reference `Object' on page 562 undefined on input line 343 16. LaTeX Warning: Hyper reference `astDelete' on page 562 undefined on input line 34316. Overfull \hbox (2.001pt too wide) in paragraph at lines 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [562] LaTeX Warning: Hyper reference `astTune' on page 563 undefined on input line 34 429. Overfull \hbox (5.3586pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 [][]\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 34429--34429 \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 34429--34429 Overfull \hbox (7.51216pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 [563] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 [564] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 565 undefined on in put line 34637. Overfull \hbox (7.51216pt too wide) in paragraph at lines 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 [] \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [565] Overfull \hbox (21.36719pt too wide) in paragraph at lines 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [566] Overfull \hbox (14.44772pt too wide) in paragraph at lines 34637--34637 [][]\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 34637--34637 [][]\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 567 undefined on input li ne 34637. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34637--34637 [][]\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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [567] LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 568 undefined on in put line 34728. Overfull \hbox (5.3586pt too wide) in paragraph at lines 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 [][]\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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 568 undefined on input li ne 34728. Overfull \hbox (5.62103pt too wide) in paragraph at lines 34728--34728 [][]\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 34728--34728 \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 34728--34728 \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 34728--34728 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [568] [569] LaTeX Warning: Hyper reference `Frame' on page 570 undefined on input line 3502 6. LaTeX Warning: Hyper reference `astFormat' on page 570 undefined on input line 35026. Overfull \hbox (0.10988pt too wide) in paragraph at lines 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 570 undefined on input line 3 5026. Overfull \hbox (18.0096pt too wide) in paragraph at lines 35026--35026 \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 35026--35026 \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 570 undefined on input line 3 5026. LaTeX Warning: Hyper reference `Current' on page 570 undefined on input line 35 026. Overfull \hbox (44.25319pt too wide) in paragraph at lines 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [570] Overfull \hbox (18.74283pt too wide) in paragraph at lines 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [571] Overfull \hbox (10.86975pt too wide) in paragraph at lines 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [572] LaTeX Warning: Hyper reference `Format(axis)' on page 573 undefined on input li ne 35026. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35026--35026 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [573] LaTeX Warning: Hyper reference `UnitMap' on page 574 undefined on input line 35 087. LaTeX Warning: Hyper reference `Mapping' on page 574 undefined on input line 35 087. Overfull \hbox (0.10988pt too wide) in paragraph at lines 35087--35087 \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 574 undefined on input line 350 87. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35087--35087 \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 35087--35087 \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 35087--35087 \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 35087--35087 [] \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 35087--35087 \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 35087--35087 \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 574 undefined on input line 350 87. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35087--35087 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [574] LaTeX Warning: Hyper reference `UnitNormMap' on page 575 undefined on input lin e 35190. LaTeX Warning: Hyper reference `Nin' on page 575 undefined on input line 35190. Overfull \hbox (26.30504pt too wide) in paragraph at lines 35190--35190 []\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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 \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 575 undefined on input line 351 90. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 [] \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 35190--35190 \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 35190--35190 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [575] LaTeX Warning: Hyper reference `Object' on page 576 undefined on input line 351 90. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35190--35190 [][]\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 35190--35190 []\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 35190--35190 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [576] LaTeX Warning: Hyper reference `Object' on page 577 undefined on input line 352 52. LaTeX Warning: Hyper reference `astLock' on page 577 undefined on input line 35 252. Overfull \hbox (47.61078pt too wide) in paragraph at lines 35252--35252 \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 35252--35252 \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 35252--35252 [][]\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 35252--35252 \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 35252--35252 [][]\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 35252--35252 [][]\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 35252--35252 \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 35252--35252 [][]\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 35252--35252 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [577] LaTeX Warning: Hyper reference `Object' on page 578 undefined on input line 352 87. Overfull \hbox (12.76088pt too wide) in paragraph at lines 35287--35287 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [578] LaTeX Warning: Hyper reference `KeyMap' on page 579 undefined on input line 353 89. LaTeX Warning: Hyper reference `astRead' on page 579 undefined on input line 35 389. LaTeX Warning: Hyper reference `astWrite' on page 579 undefined on input line 3 5389. LaTeX Warning: Hyper reference `Channel' on page 579 undefined on input line 35 389. LaTeX Warning: Hyper reference `Strict' on page 579 undefined on input line 353 89. LaTeX Warning: Hyper reference `Object' on page 579 undefined on input line 353 89. Overfull \hbox (44.25319pt too wide) in paragraph at lines 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 []\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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 579 undefined on input line 3 5389. LaTeX Warning: Hyper reference `Warnings' on page 579 undefined on input line 3 5389. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35389--35389 \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 579 undefined on input line 35 389. Overfull \hbox (33.75575pt too wide) in paragraph at lines 35389--35389 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [579] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35389--35389 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [580] LaTeX Warning: Hyper reference `astOK' on page 581 undefined on input line 3544 2. LaTeX Warning: Hyper reference `astStatus' on page 581 undefined on input line 35442. LaTeX Warning: Hyper reference `astClearStatus' on page 581 undefined on input line 35442. Overfull \hbox (0.37231pt too wide) in paragraph at lines 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [581] LaTeX Warning: Hyper reference `WcsMap' on page 582 undefined on input line 356 26. LaTeX Warning: Hyper reference `Mapping' on page 582 undefined on input line 35 626. LaTeX Warning: Hyper reference `WcsType' on page 582 undefined on input line 35 626. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 582 undefined on input line 35626. LaTeX Warning: Hyper reference `PVi_m' on page 582 undefined on input line 3562 6. Overfull \hbox (21.05632pt too wide) in paragraph at lines 35626--35626 []\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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [582] Overfull \hbox (15.85603pt too wide) in paragraph at lines 35626--35626 \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 583 undefined on input line 356 26. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 []\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 35626--35626 \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 35626--35626 \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 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 35626--35626 Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 583 undefined on input line 35626. Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 copied unchanged. Projection parameter 1 associatyed with the l atitude axis Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 \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 35626--35626 \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 35626--35626 \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 583 undefined on input line 35626. LaTeX Warning: Hyper reference `Invert' on page 583 undefined on input line 356 26. Overfull \hbox (37.11334pt too wide) in paragraph at lines 35626--35626 [][]\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 35626--35626 \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 35626--35626 \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 35626--35626 [][]\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 35626--35626 \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 35626--35626 [][]\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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [583] LaTeX Warning: Hyper reference `Object' on page 584 undefined on input line 356 26. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35626--35626 [][]\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 35626--35626 []\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 35626--35626 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [584] LaTeX Warning: Hyper reference `WinMap' on page 585 undefined on input line 357 32. LaTeX Warning: Hyper reference `Mapping' on page 585 undefined on input line 35 732. Overfull \hbox (23.4695pt too wide) in paragraph at lines 35732--35732 []\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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 585 undefined on input line 357 32. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 [] \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 35732--35732 \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 35732--35732 \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 585 undefined on input line 357 32. Overfull \hbox (5.62103pt too wide) in paragraph at lines 35732--35732 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [585] Overfull \hbox (2.26344pt too wide) in paragraph at lines 35732--35732 []\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 35732--35732 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [586] LaTeX Warning: Hyper reference `Object' on page 587 undefined on input line 357 95. LaTeX Warning: Hyper reference `Channel' on page 587 undefined on input line 35 795. LaTeX Warning: Hyper reference `FitsChan' on page 587 undefined on input line 3 5795. Overfull \hbox (7.51216pt too wide) in paragraph at lines 35795--35795 \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 35795--35795 \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 35795--35795 \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 35795--35795 [][]\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 35795--35795 [][]\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 35795--35795 \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 35795--35795 \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 35795--35795 \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 35795--35795 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [587] LaTeX Warning: Hyper reference `FitsChan' on page 588 undefined on input line 3 5832. LaTeX Warning: Hyper reference `SinkFile' on page 588 undefined on input line 3 5832. LaTeX Warning: Hyper reference `astEmptyFits' on page 588 undefined on input li ne 35832. Overfull \hbox (10.60732pt too wide) in paragraph at lines 35832--35832 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [588] LaTeX Warning: Hyper reference `XmlChan' on page 589 undefined on input line 35 933. LaTeX Warning: Hyper reference `Channel' on page 589 undefined on input line 35 933. LaTeX Warning: Hyper reference `Object' on page 589 undefined on input line 359 33. LaTeX Warning: Hyper reference `astWrite' on page 589 undefined on input line 3 5933. LaTeX Warning: Hyper reference `SinkFile' on page 589 undefined on input line 3 5933. LaTeX Warning: Hyper reference `SourceFile' on page 589 undefined on input line 35933. Overfull \hbox (8.56807pt too wide) in paragraph at lines 35933--35933 []\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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 []\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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 []\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 589 undefined on input line 359 33. Overfull \hbox (10.86975pt too wide) in paragraph at lines 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 [] \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 35933--35933 \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 35933--35933 \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 35933--35933 [][]\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 35933--35933 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [589] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35933--35933 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [590] LaTeX Warning: Hyper reference `YamlChan' on page 591 undefined on input line 3 6036. LaTeX Warning: Hyper reference `Channel' on page 591 undefined on input line 36 036. LaTeX Warning: Hyper reference `Object' on page 591 undefined on input line 360 36. LaTeX Warning: Hyper reference `astWrite' on page 591 undefined on input line 3 6036. LaTeX Warning: Hyper reference `SinkFile' on page 591 undefined on input line 3 6036. LaTeX Warning: Hyper reference `SourceFile' on page 591 undefined on input line 36036. Overfull \hbox (8.09445pt too wide) in paragraph at lines 36036--36036 []\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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 []\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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 []\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 36. Overfull \hbox (10.86975pt too wide) in paragraph at lines 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 [] \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 36036--36036 \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 36036--36036 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [591] Overfull \hbox (8.24539pt too wide) in paragraph at lines 36036--36036 [][]\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 36036--36036 \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 36036--36036 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [592] LaTeX Warning: Hyper reference `ZoomMap' on page 593 undefined on input line 36 117. LaTeX Warning: Hyper reference `Mapping' on page 593 undefined on input line 36 117. Overfull \hbox (26.09103pt too wide) in paragraph at lines 36117--36117 \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 36117--36117 \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 593 undefined on input line 36117 . Overfull \hbox (37.11334pt too wide) in paragraph at lines 36117--36117 \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 36117--36117 \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 36117--36117 \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 593 undefined on input line 361 17. Overfull \hbox (10.86975pt too wide) in paragraph at lines 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 [] \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 36117--36117 \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 36117--36117 \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 593 undefined on input line 361 17. Overfull \hbox (5.62103pt too wide) in paragraph at lines 36117--36117 [][]\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 36117--36117 []\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 36117--36117 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [593] [594] [595] LaTeX Warning: Hyper reference `astGrid' on page 596 undefined on input line 36 161. LaTeX Warning: Hyper reference `Plot' on page 596 undefined on input line 36161 . [596] LaTeX Warning: Hyper reference `Region' on page 597 undefined on input line 362 22. LaTeX Warning: Hyper reference `System' on page 597 undefined on input line 362 22. LaTeX Warning: Hyper reference `Mapping' on page 597 undefined on input line 36 222. LaTeX Warning: Hyper reference `Epoch' on page 597 undefined on input line 3622 2. [597] LaTeX Warning: Hyper reference `SkyFrame' on page 598 undefined on input line 3 6255. LaTeX Warning: Hyper reference `astFindFrame' on page 598 undefined on input li ne 36255. LaTeX Warning: Hyper reference `astConvert' on page 598 undefined on input line 36255. LaTeX Warning: Hyper reference `SkyRefIs' on page 598 undefined on input line 3 6255. LaTeX Warning: Hyper reference `UnitMap' on page 598 undefined on input line 36 255. LaTeX Warning: Hyper reference `AlignSystem' on page 598 undefined on input lin e 36255. [598] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 599 undefined on input li ne 36323. LaTeX Warning: Hyper reference `astFindFrame' on page 599 undefined on input li ne 36323. LaTeX Warning: Hyper reference `astConvert' on page 599 undefined on input line 36323. LaTeX Warning: Hyper reference `SideBand' on page 599 undefined on input line 3 6323. LaTeX Warning: Hyper reference `Mapping' on page 599 undefined on input line 36 323. LaTeX Warning: Hyper reference `SpecFrame' on page 599 undefined on input line 36323. LaTeX Warning: Hyper reference `System' on page 599 undefined on input line 363 23. LaTeX Warning: Hyper reference `StdOfRest' on page 599 undefined on input line 36323. [599] LaTeX Warning: Hyper reference `SpecFrame' on page 600 undefined on input line 36353. LaTeX Warning: Hyper reference `astFindFrame' on page 600 undefined on input li ne 36353. LaTeX Warning: Hyper reference `astConvert' on page 600 undefined on input line 36353. [600] LaTeX Warning: Hyper reference `SpecFrame' on page 601 undefined on input line 36408. LaTeX Warning: Hyper reference `astFindFrame' on page 601 undefined on input li ne 36408. LaTeX Warning: Hyper reference `astConvert' on page 601 undefined on input line 36408. LaTeX Warning: Hyper reference `StdOfRest' on page 601 undefined on input line 36408. LaTeX Warning: Hyper reference `Mapping' on page 601 undefined on input line 36 408. LaTeX Warning: Hyper reference `AlignSystem' on page 601 undefined on input lin e 36408. LaTeX Warning: Hyper reference `Epoch' on page 601 undefined on input line 3640 8. LaTeX Warning: Hyper reference `ObsLat' on page 601 undefined on input line 364 08. LaTeX Warning: Hyper reference `ObsLon' on page 601 undefined on input line 364 08. LaTeX Warning: Hyper reference `ObsAlt' on page 601 undefined on input line 364 08. LaTeX Warning: Hyper reference `RefDec' on page 601 undefined on input line 364 08. LaTeX Warning: Hyper reference `RefRA' on page 601 undefined on input line 3640 8. [601] LaTeX Warning: Hyper reference `Frame' on page 602 undefined on input line 3647 3. LaTeX Warning: Hyper reference `astFindFrame' on page 602 undefined on input li ne 36473. LaTeX Warning: Hyper reference `astConvert' on page 602 undefined on input line 36473. LaTeX Warning: Hyper reference `System' on page 602 undefined on input line 364 73. LaTeX Warning: Hyper reference `Mapping' on page 602 undefined on input line 36 473. LaTeX Warning: Hyper reference `CmpFrame' on page 602 undefined on input line 3 6473. LaTeX Warning: Hyper reference `FrameSet' on page 602 undefined on input line 3 6473. LaTeX Warning: Hyper reference `Current' on page 602 undefined on input line 36 473. LaTeX Warning: Hyper reference `SkyFrame' on page 602 undefined on input line 3 6473. LaTeX Warning: Hyper reference `SpecFrame' on page 602 undefined on input line 36473. LaTeX Warning: Hyper reference `TimeFrame' on page 602 undefined on input line 36473. [602] LaTeX Warning: Hyper reference `TimeFrame' on page 603 undefined on input line 36524. LaTeX Warning: Hyper reference `astFindFrame' on page 603 undefined on input li ne 36524. LaTeX Warning: Hyper reference `astConvert' on page 603 undefined on input line 36524. LaTeX Warning: Hyper reference `TimeScale' on page 603 undefined on input line 36524. LaTeX Warning: Hyper reference `Mapping' on page 603 undefined on input line 36 524. LaTeX Warning: Hyper reference `AlignSystem' on page 603 undefined on input lin e 36524. [603] LaTeX Warning: Hyper reference `Frame' on page 604 undefined on input line 3654 7. LaTeX Warning: Hyper reference `Variant' on page 604 undefined on input line 36 547. LaTeX Warning: Hyper reference `Domain' on page 604 undefined on input line 365 47. LaTeX Warning: Hyper reference `FrameSet' on page 604 undefined on input line 3 6547. [604] LaTeX Warning: Hyper reference `Warnings' on page 605 undefined on input line 3 6681. LaTeX Warning: Hyper reference `FitsChan' on page 605 undefined on input line 3 6681. LaTeX Warning: Hyper reference `FrameSet' on page 605 undefined on input line 3 6681. LaTeX Warning: Hyper reference `PVi_m' on page 605 undefined on input line 3668 1. LaTeX Warning: Hyper reference `astRead' on page 605 undefined on input line 36 681. [605] [606] LaTeX Warning: Hyper reference `astFormat' on page 607 undefined on input line 36730. LaTeX Warning: Hyper reference `SkyFrame' on page 607 undefined on input line 3 6730. LaTeX Warning: Hyper reference `System' on page 607 undefined on input line 367 30. LaTeX Warning: Hyper reference `Format(axis)' on page 607 undefined on input li ne 36730. LaTeX Warning: Hyper reference `Unit(axis)' on page 607 undefined on input line 36730. [607] LaTeX Warning: Hyper reference `Frame' on page 608 undefined on input line 3676 8. LaTeX Warning: Hyper reference `FrameSet' on page 608 undefined on input line 3 6768. LaTeX Warning: Hyper reference `Domain' on page 608 undefined on input line 367 68. LaTeX Warning: Hyper reference `Invert' on page 608 undefined on input line 367 68. LaTeX Warning: Hyper reference `astInvert' on page 608 undefined on input line 36768. LaTeX Warning: Hyper reference `Current' on page 608 undefined on input line 36 768. [608] LaTeX Warning: Hyper reference `astGrid' on page 609 undefined on input line 36 799. LaTeX Warning: Hyper reference `Plot' on page 609 undefined on input line 36799 . LaTeX Warning: Hyper reference `astBorder' on page 609 undefined on input line 36799. LaTeX Warning: Hyper reference `Labelling' on page 609 undefined on input line 36799. [609] LaTeX Warning: Hyper reference `astGrid' on page 610 undefined on input line 36 836. LaTeX Warning: Hyper reference `Frame' on page 610 undefined on input line 3683 6. LaTeX Warning: Hyper reference `SkyFrame' on page 610 undefined on input line 3 6836. [610] LaTeX Warning: Hyper reference `Region' on page 611 undefined on input line 368 57. [611] LaTeX Warning: Hyper reference `FitsChan' on page 612 undefined on input line 3 6906. LaTeX Warning: Hyper reference `FrameSet' on page 612 undefined on input line 3 6906. LaTeX Warning: Hyper reference `Encoding' on page 612 undefined on input line 3 6906. [612] LaTeX Warning: Hyper reference `FrameSet' on page 613 undefined on input line 3 6943. LaTeX Warning: Hyper reference `Mapping' on page 613 undefined on input line 36 943. LaTeX Warning: Hyper reference `FitsChan' on page 613 undefined on input line 3 6943. [613] LaTeX Warning: Hyper reference `FitsChan' on page 614 undefined on input line 3 6980. LaTeX Warning: Hyper reference `astDelFits' on page 614 undefined on input line 36980. LaTeX Warning: Hyper reference `astFindFits' on page 614 undefined on input lin e 36980. LaTeX Warning: Hyper reference `astPutFits' on page 614 undefined on input line 36980. LaTeX Warning: Hyper reference `astClear' on page 614 undefined on input line 3 6980. LaTeX Warning: Hyper reference `Ncard' on page 614 undefined on input line 3698 0. [614] LaTeX Warning: Hyper reference `FitsChan' on page 615 undefined on input line 3 7000. [615] LaTeX Warning: Hyper reference `FitsChan' on page 616 undefined on input line 3 7020. [616] LaTeX Warning: Hyper reference `FitsChan' on page 617 undefined on input line 3 7043. Overfull \hbox (37.49187pt too wide) in paragraph at lines 37043--37043 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [617] LaTeX Warning: Hyper reference `Object' on page 618 undefined on input line 370 63. [618] LaTeX Warning: Hyper reference `FitsChan' on page 619 undefined on input line 3 7096. LaTeX Warning: Hyper reference `astRead' on page 619 undefined on input line 37 096. LaTeX Warning: Hyper reference `Object' on page 619 undefined on input line 370 96. [619] LaTeX Warning: Hyper reference `Plot' on page 620 undefined on input line 37129 . LaTeX Warning: Hyper reference `astClip' on page 620 undefined on input line 37 129. [620] LaTeX Warning: Hyper reference `Plot' on page 621 undefined on input line 37164 . LaTeX Warning: Hyper reference `astClip' on page 621 undefined on input line 37 164. LaTeX Warning: Hyper reference `Frame' on page 621 undefined on input line 3716 4. [621] LaTeX Warning: Hyper reference `Region' on page 622 undefined on input line 372 17. LaTeX Warning: Hyper reference `PointList' on page 622 undefined on input line 37217. LaTeX Warning: Hyper reference `CmpRegion' on page 622 undefined on input line 37217. LaTeX Warning: Hyper reference `Stc' on page 622 undefined on input line 37217. LaTeX Warning: Hyper reference `Moc' on page 622 undefined on input line 37217. [622] LaTeX Warning: Hyper reference `Plot' on page 623 undefined on input line 37262 . [623] LaTeX Warning: Hyper reference `Table' on page 624 undefined on input line 3729 7. [624] LaTeX Warning: Hyper reference `Table' on page 625 undefined on input line 3732 0. [625] LaTeX Warning: Hyper reference `Table' on page 626 undefined on input line 3734 4. [626] LaTeX Warning: Hyper reference `Table' on page 627 undefined on input line 3738 0. LaTeX Warning: Hyper reference `astAddColumn' on page 627 undefined on input li ne 37380. LaTeX Warning: Hyper reference `Object' on page 627 undefined on input line 373 80. LaTeX Warning: Hyper reference `astMapPutU' on page 627 undefined on input line 37380. [627] LaTeX Warning: Hyper reference `Channel' on page 628 undefined on input line 37 421. LaTeX Warning: Hyper reference `FitsChan' on page 628 undefined on input line 3 7421. LaTeX Warning: Hyper reference `XmlChan' on page 628 undefined on input line 37 421. LaTeX Warning: Hyper reference `YamlChan' on page 628 undefined on input line 3 7421. [628] LaTeX Warning: Hyper reference `Frame' on page 629 undefined on input line 3745 9. LaTeX Warning: Hyper reference `FrameSet' on page 629 undefined on input line 3 7459. LaTeX Warning: Hyper reference `Nframe' on page 629 undefined on input line 374 59. LaTeX Warning: Hyper reference `Domain' on page 629 undefined on input line 374 59. LaTeX Warning: Hyper reference `Invert' on page 629 undefined on input line 374 59. LaTeX Warning: Hyper reference `astInvert' on page 629 undefined on input line 37459. LaTeX Warning: Hyper reference `Base' on page 629 undefined on input line 37459 . [629] LaTeX Warning: Hyper reference `IF' on page 630 undefined on input line 37513. LaTeX Warning: Hyper reference `SpecFrame' on page 630 undefined on input line 37513. LaTeX Warning: Hyper reference `System' on page 630 undefined on input line 375 13. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 630 undefined on input li ne 37513. LaTeX Warning: Hyper reference `StdOfRest' on page 630 undefined on input line 37513. LaTeX Warning: Hyper reference `ObsLon' on page 630 undefined on input line 375 13. LaTeX Warning: Hyper reference `ObsLat' on page 630 undefined on input line 375 13. LaTeX Warning: Hyper reference `ObsAlt' on page 630 undefined on input line 375 13. LaTeX Warning: Hyper reference `Epoch' on page 630 undefined on input line 3751 3. LaTeX Warning: Hyper reference `RefRA' on page 630 undefined on input line 3751 3. LaTeX Warning: Hyper reference `RefDec' on page 630 undefined on input line 375 13. LaTeX Warning: Hyper reference `RestFreq' on page 630 undefined on input line 3 7513. [630] LaTeX Warning: Hyper reference `FrameSet' on page 631 undefined on input line 3 7540. LaTeX Warning: Hyper reference `FitsChan' on page 631 undefined on input line 3 7540. LaTeX Warning: Hyper reference `Encoding' on page 631 undefined on input line 3 7540. [631] LaTeX Warning: Hyper reference `Frame' on page 632 undefined on input line 3759 3. LaTeX Warning: Hyper reference `astFormat' on page 632 undefined on input line 37593. LaTeX Warning: Hyper reference `FrameSet' on page 632 undefined on input line 3 7593. LaTeX Warning: Hyper reference `Current' on page 632 undefined on input line 37 593. LaTeX Warning: Hyper reference `Plot' on page 632 undefined on input line 37593 . LaTeX Warning: Hyper reference `TimeFrame' on page 632 undefined on input line 37593. [632] LaTeX Warning: Hyper reference `Frame' on page 633 undefined on input line 3765 8. LaTeX Warning: Hyper reference `SkyFrame' on page 633 undefined on input line 3 7658. LaTeX Warning: Hyper reference `FrameSet' on page 633 undefined on input line 3 7658. LaTeX Warning: Hyper reference `Current' on page 633 undefined on input line 37 658. LaTeX Warning: Hyper reference `Plot' on page 633 undefined on input line 37658 . [633] LaTeX Warning: Hyper reference `PcdMap' on page 634 undefined on input line 376 97. LaTeX Warning: Hyper reference `astInvert' on page 634 undefined on input line 37697. LaTeX Warning: Hyper reference `CmpMap' on page 634 undefined on input line 376 97. LaTeX Warning: Hyper reference `FrameSet' on page 634 undefined on input line 3 7697. LaTeX Warning: Hyper reference `astClone' on page 634 undefined on input line 3 7697. [634] LaTeX Warning: Hyper reference `Frame' on page 635 undefined on input line 3778 5. LaTeX Warning: Hyper reference `astFindFrame' on page 635 undefined on input li ne 37785. LaTeX Warning: Hyper reference `SkyFrame' on page 635 undefined on input line 3 7785. LaTeX Warning: Hyper reference `CmpFrame' on page 635 undefined on input line 3 7785. LaTeX Warning: Hyper reference `FrameSet' on page 635 undefined on input line 3 7785. LaTeX Warning: Hyper reference `Current' on page 635 undefined on input line 37 785. LaTeX Warning: Hyper reference `SpecFrame' on page 635 undefined on input line 37785. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 635 undefined on input li ne 37785. LaTeX Warning: Hyper reference `FluxFrame' on page 635 undefined on input line 37785. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 635 undefined on input l ine 37785. LaTeX Warning: Hyper reference `TimeFrame' on page 635 undefined on input line 37785. [635] LaTeX Warning: Hyper reference `astGrid' on page 636 undefined on input line 37 838. LaTeX Warning: Hyper reference `Plot' on page 636 undefined on input line 37838 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 636 undefined on input l ine 37838. LaTeX Warning: Hyper reference `Axis' on page 636 undefined on input line 37838 . LaTeX Warning: Hyper reference `Grid' on page 636 undefined on input line 37838 . LaTeX Warning: Hyper reference `Labelling' on page 636 undefined on input line 37838. [636] LaTeX Warning: Hyper reference `astGrid' on page 637 undefined on input line 37 880. LaTeX Warning: Hyper reference `Plot' on page 637 undefined on input line 37880 . LaTeX Warning: Hyper reference `Plot3D' on page 637 undefined on input line 378 80. LaTeX Warning: Hyper reference `Title' on page 637 undefined on input line 3788 0. LaTeX Warning: Hyper reference `TitleGap' on page 637 undefined on input line 3 7880. [637] LaTeX Warning: Hyper reference `Frame' on page 638 undefined on input line 3790 7. LaTeX Warning: Hyper reference `Epoch' on page 638 undefined on input line 3790 7. [638] LaTeX Warning: Hyper reference `SkyFrame' on page 639 undefined on input line 3 7943. LaTeX Warning: Hyper reference `Epoch' on page 639 undefined on input line 3794 3. LaTeX Warning: Hyper reference `Frame' on page 639 undefined on input line 3794 3. [639] LaTeX Warning: Hyper reference `astGrid' on page 640 undefined on input line 37 995. LaTeX Warning: Hyper reference `Plot' on page 640 undefined on input line 37995 . LaTeX Warning: Hyper reference `Labelling' on page 640 undefined on input line 37995. LaTeX Warning: Hyper reference `Plot3D' on page 640 undefined on input line 379 95. LaTeX Warning: Hyper reference `RootCorner' on page 640 undefined on input line 37995. [640] LaTeX Warning: Hyper reference `FitsChan' on page 641 undefined on input line 3 8618. LaTeX Warning: Hyper reference `astWrite' on page 641 undefined on input line 3 8618. LaTeX Warning: Hyper reference `astRead' on page 641 undefined on input line 38 618. LaTeX Warning: Hyper reference `Object' on page 641 undefined on input line 386 18. LaTeX Warning: Hyper reference `Channel' on page 641 undefined on input line 38 618. [641] [642] LaTeX Warning: Hyper reference `FrameSet' on page 643 undefined on input line 3 8618. LaTeX Warning: Hyper reference `Mapping' on page 643 undefined on input line 38 618. LaTeX Warning: Hyper reference `DssMap' on page 643 undefined on input line 386 18. LaTeX Warning: Hyper reference `WcsMap' on page 643 undefined on input line 386 18. LaTeX Warning: Hyper reference `Card' on page 643 undefined on input line 38618 . LaTeX Warning: Hyper reference `Frame' on page 643 undefined on input line 3861 8. LaTeX Warning: Hyper reference `SkyFrame' on page 643 undefined on input line 3 8618. [643] LaTeX Warning: Hyper reference `CDMatrix' on page 644 undefined on input line 3 8618. LaTeX Warning: Hyper reference `PVi_m' on page 644 undefined on input line 3861 8. LaTeX Warning: Hyper reference `SkyRefIs' on page 644 undefined on input line 3 8618. LaTeX Warning: Hyper reference `System' on page 644 undefined on input line 386 18. [644] [645] LaTeX Warning: Hyper reference `SpecFrame' on page 646 undefined on input line 38618. LaTeX Warning: Hyper reference `ObsLat' on page 646 undefined on input line 386 18. LaTeX Warning: Hyper reference `ObsLon' on page 646 undefined on input line 386 18. LaTeX Warning: Hyper reference `ObsAlt' on page 646 undefined on input line 386 18. [646] LaTeX Warning: Hyper reference `SourceVel' on page 647 undefined on input line 38618. LaTeX Warning: Hyper reference `SourceVRF' on page 647 undefined on input line 38618. LaTeX Warning: Hyper reference `Class' on page 647 undefined on input line 3861 8. LaTeX Warning: Hyper reference `ID' on page 647 undefined on input line 38618. [647] LaTeX Warning: Hyper reference `Frame' on page 648 undefined on input line 3876 6. LaTeX Warning: Hyper reference `System' on page 648 undefined on input line 387 66. LaTeX Warning: Hyper reference `CmpFrame' on page 648 undefined on input line 3 8766. LaTeX Warning: Hyper reference `FrameSet' on page 648 undefined on input line 3 8766. LaTeX Warning: Hyper reference `Current' on page 648 undefined on input line 38 766. LaTeX Warning: Hyper reference `SkyFrame' on page 648 undefined on input line 3 8766. LaTeX Warning: Hyper reference `Equinox' on page 648 undefined on input line 38 766. LaTeX Warning: Hyper reference `TimeFrame' on page 648 undefined on input line 38766. LaTeX Warning: Hyper reference `TimeOrigin' on page 648 undefined on input line 38766. [648] [649] LaTeX Warning: Hyper reference `SkyFrame' on page 650 undefined on input line 3 8833. LaTeX Warning: Hyper reference `Epoch' on page 650 undefined on input line 3883 3. LaTeX Warning: Hyper reference `System' on page 650 undefined on input line 388 33. [650] LaTeX Warning: Hyper reference `astGrid' on page 651 undefined on input line 38 940. LaTeX Warning: Hyper reference `Plot' on page 651 undefined on input line 38940 . LaTeX Warning: Hyper reference `astText' on page 651 undefined on input line 38 940. LaTeX Warning: Hyper reference `Plot3D' on page 651 undefined on input line 389 40. LaTeX Warning: Hyper reference `astEscapes' on page 651 undefined on input line 38940. [651] [652] LaTeX Warning: Hyper reference `Region' on page 653 undefined on input line 389 83. LaTeX Warning: Hyper reference `CmpRegion' on page 653 undefined on input line 38983. LaTeX Warning: Hyper reference `Prism' on page 653 undefined on input line 3898 3. LaTeX Warning: Hyper reference `Stc' on page 653 undefined on input line 38983. [653] LaTeX Warning: Hyper reference `astWrite' on page 654 undefined on input line 3 9026. LaTeX Warning: Hyper reference `Frame' on page 654 undefined on input line 3902 6. LaTeX Warning: Hyper reference `FrameSet' on page 654 undefined on input line 3 9026. LaTeX Warning: Hyper reference `FitsChan' on page 654 undefined on input line 3 9026. [654] LaTeX Warning: Hyper reference `FitsChan' on page 655 undefined on input line 3 9068. LaTeX Warning: Hyper reference `astFindFits' on page 655 undefined on input lin e 39068. [655] LaTeX Warning: Hyper reference `FrameSet' on page 656 undefined on input line 3 9097. LaTeX Warning: Hyper reference `FitsChan' on page 656 undefined on input line 3 9097. LaTeX Warning: Hyper reference `Mapping' on page 656 undefined on input line 39 097. [656] LaTeX Warning: Hyper reference `Plot' on page 657 undefined on input line 39141 . [657] LaTeX Warning: Hyper reference `FrameSet' on page 658 undefined on input line 3 9173. LaTeX Warning: Hyper reference `TabOK' on page 658 undefined on input line 3917 3. LaTeX Warning: Hyper reference `astWrite' on page 658 undefined on input line 3 9173. LaTeX Warning: Hyper reference `FitsChan' on page 658 undefined on input line 3 9173. [658] LaTeX Warning: Hyper reference `Frame' on page 659 undefined on input line 3937 0. LaTeX Warning: Hyper reference `astFormat' on page 659 undefined on input line 39370. LaTeX Warning: Hyper reference `astSet' on page 659 undefined on input line 393 70. LaTeX Warning: Hyper reference `SkyFrame' on page 659 undefined on input line 3 9370. LaTeX Warning: Hyper reference `FrameSet' on page 659 undefined on input line 3 9370. LaTeX Warning: Hyper reference `Current' on page 659 undefined on input line 39 370. LaTeX Warning: Hyper reference `TimeFrame' on page 659 undefined on input line 39370. [659] LaTeX Warning: Hyper reference `Plot' on page 660 undefined on input line 39370 . LaTeX Warning: Hyper reference `TimeOrigin' on page 660 undefined on input line 39370. [660] [661] LaTeX Warning: Hyper reference `Channel' on page 662 undefined on input line 39 427. LaTeX Warning: Hyper reference `Object' on page 662 undefined on input line 394 27. LaTeX Warning: Hyper reference `FitsChan' on page 662 undefined on input line 3 9427. LaTeX Warning: Hyper reference `StcsChan' on page 662 undefined on input line 3 9427. LaTeX Warning: Hyper reference `XmlChan' on page 662 undefined on input line 39 427. LaTeX Warning: Hyper reference `YamlChan' on page 662 undefined on input line 3 9427. [662] LaTeX Warning: Hyper reference `astGrid' on page 663 undefined on input line 39 479. LaTeX Warning: Hyper reference `Plot' on page 663 undefined on input line 39479 . LaTeX Warning: Hyper reference `Format(axis)' on page 663 undefined on input li ne 39479. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 663 undefined on i nput line 39479. [663] LaTeX Warning: Hyper reference `Plot' on page 664 undefined on input line 39522 . LaTeX Warning: Hyper reference `ast_link' on page 664 undefined on input line 3 9522. LaTeX Warning: Hyper reference `astGrfSet' on page 664 undefined on input line 39522. LaTeX Warning: Hyper reference `Plot3D' on page 664 undefined on input line 395 22. LaTeX Warning: Hyper reference `Channel' on page 664 undefined on input line 39 522. LaTeX Warning: Hyper reference `astRead' on page 664 undefined on input line 39 522. [664] LaTeX Warning: Hyper reference `astGrid' on page 665 undefined on input line 39 558. LaTeX Warning: Hyper reference `Plot' on page 665 undefined on input line 39558 . LaTeX Warning: Hyper reference `Gap(axis)' on page 665 undefined on input line 39558. [665] LaTeX Warning: Hyper reference `GrismMap' on page 666 undefined on input line 3 9585. LaTeX Warning: Hyper reference `CmpMap' on page 666 undefined on input line 395 85. LaTeX Warning: Hyper reference `FrameSet' on page 666 undefined on input line 3 9585. LaTeX Warning: Hyper reference `astClone' on page 666 undefined on input line 3 9585. [666] LaTeX Warning: Hyper reference `GrismMap' on page 667 undefined on input line 3 9614. LaTeX Warning: Hyper reference `CmpMap' on page 667 undefined on input line 396 14. LaTeX Warning: Hyper reference `FrameSet' on page 667 undefined on input line 3 9614. LaTeX Warning: Hyper reference `astClone' on page 667 undefined on input line 3 9614. [667] LaTeX Warning: Hyper reference `GrismWaveR' on page 668 undefined on input line 39643. LaTeX Warning: Hyper reference `GrismNRP' on page 668 undefined on input line 3 9643. LaTeX Warning: Hyper reference `GrismMap' on page 668 undefined on input line 3 9643. LaTeX Warning: Hyper reference `CmpMap' on page 668 undefined on input line 396 43. LaTeX Warning: Hyper reference `FrameSet' on page 668 undefined on input line 3 9643. LaTeX Warning: Hyper reference `astClone' on page 668 undefined on input line 3 9643. [668] LaTeX Warning: Hyper reference `GrismMap' on page 669 undefined on input line 3 9670. LaTeX Warning: Hyper reference `CmpMap' on page 669 undefined on input line 396 70. LaTeX Warning: Hyper reference `FrameSet' on page 669 undefined on input line 3 9670. LaTeX Warning: Hyper reference `astClone' on page 669 undefined on input line 3 9670. [669] LaTeX Warning: Hyper reference `GrismWaveR' on page 670 undefined on input line 39698. LaTeX Warning: Hyper reference `GrismMap' on page 670 undefined on input line 3 9698. LaTeX Warning: Hyper reference `CmpMap' on page 670 undefined on input line 396 98. LaTeX Warning: Hyper reference `FrameSet' on page 670 undefined on input line 3 9698. LaTeX Warning: Hyper reference `astClone' on page 670 undefined on input line 3 9698. [670] LaTeX Warning: Hyper reference `GrismWaveR' on page 671 undefined on input line 39729. LaTeX Warning: Hyper reference `GrismG' on page 671 undefined on input line 397 29. LaTeX Warning: Hyper reference `GrismMap' on page 671 undefined on input line 3 9729. LaTeX Warning: Hyper reference `CmpMap' on page 671 undefined on input line 397 29. LaTeX Warning: Hyper reference `FrameSet' on page 671 undefined on input line 3 9729. LaTeX Warning: Hyper reference `astClone' on page 671 undefined on input line 3 9729. [671] LaTeX Warning: Hyper reference `GrismWaveR' on page 672 undefined on input line 39759. LaTeX Warning: Hyper reference `GrismMap' on page 672 undefined on input line 3 9759. LaTeX Warning: Hyper reference `CmpMap' on page 672 undefined on input line 397 59. LaTeX Warning: Hyper reference `FrameSet' on page 672 undefined on input line 3 9759. LaTeX Warning: Hyper reference `astClone' on page 672 undefined on input line 3 9759. [672] LaTeX Warning: Hyper reference `GrismNRP' on page 673 undefined on input line 3 9787. LaTeX Warning: Hyper reference `GrismG' on page 673 undefined on input line 397 87. LaTeX Warning: Hyper reference `GrismMap' on page 673 undefined on input line 3 9787. LaTeX Warning: Hyper reference `CmpMap' on page 673 undefined on input line 397 87. LaTeX Warning: Hyper reference `FrameSet' on page 673 undefined on input line 3 9787. LaTeX Warning: Hyper reference `astClone' on page 673 undefined on input line 3 9787. [673] LaTeX Warning: Hyper reference `Object' on page 674 undefined on input line 398 30. LaTeX Warning: Hyper reference `astWrite' on page 674 undefined on input line 3 9830. LaTeX Warning: Hyper reference `astRead' on page 674 undefined on input line 39 830. LaTeX Warning: Hyper reference `astShow' on page 674 undefined on input line 39 830. [674] LaTeX Warning: Hyper reference `DSBCentre' on page 675 undefined on input line 39871. LaTeX Warning: Hyper reference `SideBand' on page 675 undefined on input line 3 9871. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 675 undefined on input li ne 39871. [675] LaTeX Warning: Hyper reference `ID' on page 676 undefined on input line 39893. LaTeX Warning: Hyper reference `Object' on page 676 undefined on input line 398 93. [676] LaTeX Warning: Hyper reference `RestFreq' on page 677 undefined on input line 3 9924. LaTeX Warning: Hyper reference `SourceVel' on page 677 undefined on input line 39924. LaTeX Warning: Hyper reference `SourceVRF' on page 677 undefined on input line 39924. LaTeX Warning: Hyper reference `DSBCentre' on page 677 undefined on input line 39924. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 677 undefined on input li ne 39924. [677] LaTeX Warning: Hyper reference `astWrite' on page 678 undefined on input line 4 0001. LaTeX Warning: Hyper reference `Channel' on page 678 undefined on input line 40 001. LaTeX Warning: Hyper reference `FitsChan' on page 678 undefined on input line 4 0001. LaTeX Warning: Hyper reference `StcsChan' on page 678 undefined on input line 4 0001. LaTeX Warning: Hyper reference `StcsLength' on page 678 undefined on input line 40001. LaTeX Warning: Hyper reference `XmlChan' on page 678 undefined on input line 40 001. LaTeX Warning: Hyper reference `YamlChan' on page 678 undefined on input line 4 0001. [678] LaTeX Warning: Hyper reference `Frame' on page 679 undefined on input line 4003 7. LaTeX Warning: Hyper reference `SkyFrame' on page 679 undefined on input line 4 0037. [679] LaTeX Warning: Hyper reference `IntraMap' on page 680 undefined on input line 4 0079. LaTeX Warning: Hyper reference `UnitMap' on page 680 undefined on input line 40 079. LaTeX Warning: Hyper reference `astSimplify' on page 680 undefined on input lin e 40079. [680] LaTeX Warning: Hyper reference `Mapping' on page 681 undefined on input line 40 128. LaTeX Warning: Hyper reference `Nin' on page 681 undefined on input line 40128. LaTeX Warning: Hyper reference `Nout' on page 681 undefined on input line 40128 . LaTeX Warning: Hyper reference `TranForward' on page 681 undefined on input lin e 40128. LaTeX Warning: Hyper reference `TranInverse' on page 681 undefined on input lin e 40128. LaTeX Warning: Hyper reference `astInvert' on page 681 undefined on input line 40128. LaTeX Warning: Hyper reference `UnitMap' on page 681 undefined on input line 40 128. LaTeX Warning: Hyper reference `FrameSet' on page 681 undefined on input line 4 0128. LaTeX Warning: Hyper reference `Base' on page 681 undefined on input line 40128 . LaTeX Warning: Hyper reference `Current' on page 681 undefined on input line 40 128. LaTeX Warning: Hyper reference `Naxes' on page 681 undefined on input line 4012 8. LaTeX Warning: Hyper reference `Frame' on page 681 undefined on input line 4012 8. [681] LaTeX Warning: Hyper reference `Plot' on page 682 undefined on input line 40158 . LaTeX Warning: Hyper reference `astBoundingBox' on page 682 undefined on input line 40158. [682] LaTeX Warning: Hyper reference `SkyFrame' on page 683 undefined on input line 4 0188. [683] LaTeX Warning: Hyper reference `Mapping' on page 684 undefined on input line 40 235. LaTeX Warning: Hyper reference `MathMap' on page 684 undefined on input line 40 235. LaTeX Warning: Hyper reference `astLinearApprox' on page 684 undefined on input line 40235. LaTeX Warning: Hyper reference `CmpMap' on page 684 undefined on input line 402 35. LaTeX Warning: Hyper reference `ZoomMap' on page 684 undefined on input line 40 235. LaTeX Warning: Hyper reference `ShiftMap' on page 684 undefined on input line 4 0235. LaTeX Warning: Hyper reference `Frame' on page 684 undefined on input line 4023 5. LaTeX Warning: Hyper reference `UnitMap' on page 684 undefined on input line 40 235. LaTeX Warning: Hyper reference `FrameSet' on page 684 undefined on input line 4 0235. [684] LaTeX Warning: Hyper reference `SkyFrame' on page 685 undefined on input line 4 0265. [685] LaTeX Warning: Hyper reference `Mapping' on page 686 undefined on input line 40 303. LaTeX Warning: Hyper reference `astSimplify' on page 686 undefined on input lin e 40303. LaTeX Warning: Hyper reference `Frame' on page 686 undefined on input line 4030 3. [686] LaTeX Warning: Hyper reference `PolyMap' on page 687 undefined on input line 40 383. LaTeX Warning: Hyper reference `NiterInverse' on page 687 undefined on input li ne 40383. LaTeX Warning: Hyper reference `TolInverse' on page 687 undefined on input line 40383. LaTeX Warning: Hyper reference `ChebyMap' on page 687 undefined on input line 4 0383. LaTeX Warning: Hyper reference `Nin' on page 687 undefined on input line 40383. LaTeX Warning: Hyper reference `Nout' on page 687 undefined on input line 40383 . [687] LaTeX Warning: Hyper reference `FrameSet' on page 688 undefined on input line 4 0418. LaTeX Warning: Hyper reference `FitsChan' on page 688 undefined on input line 4 0418. LaTeX Warning: Hyper reference `astRead' on page 688 undefined on input line 40 418. LaTeX Warning: Hyper reference `Domain' on page 688 undefined on input line 404 18. [688] LaTeX Warning: Hyper reference `KeyMap' on page 689 undefined on input line 404 52. LaTeX Warning: Hyper reference `Table' on page 689 undefined on input line 4045 2. [689] LaTeX Warning: Hyper reference `KeyMap' on page 690 undefined on input line 404 89. [690] LaTeX Warning: Hyper reference `TimeFrame' on page 691 undefined on input line 40511. [691] LaTeX Warning: Hyper reference `Frame' on page 692 undefined on input line 4056 8. LaTeX Warning: Hyper reference `Axis' on page 692 undefined on input line 40568 . LaTeX Warning: Hyper reference `SkyFrame' on page 692 undefined on input line 4 0568. LaTeX Warning: Hyper reference `TimeFrame' on page 692 undefined on input line 40568. LaTeX Warning: Hyper reference `FrameSet' on page 692 undefined on input line 4 0568. LaTeX Warning: Hyper reference `Current' on page 692 undefined on input line 40 568. [692] LaTeX Warning: Hyper reference `astGrid' on page 693 undefined on input line 40 627. LaTeX Warning: Hyper reference `Plot' on page 693 undefined on input line 40627 . LaTeX Warning: Hyper reference `Labelling' on page 693 undefined on input line 40627. [693] LaTeX Warning: Hyper reference `astGrid' on page 694 undefined on input line 40 680. LaTeX Warning: Hyper reference `Plot' on page 694 undefined on input line 40680 . LaTeX Warning: Hyper reference `Frame' on page 694 undefined on input line 4068 0. LaTeX Warning: Hyper reference `SkyFrame' on page 694 undefined on input line 4 0680. LaTeX Warning: Hyper reference `Unit(axis)' on page 694 undefined on input line 40680. [694] LaTeX Warning: Hyper reference `astGrid' on page 695 undefined on input line 40 731. LaTeX Warning: Hyper reference `Plot' on page 695 undefined on input line 40731 . LaTeX Warning: Hyper reference `Labelling' on page 695 undefined on input line 40731. [695] LaTeX Warning: Hyper reference `astGrid' on page 696 undefined on input line 40 767. LaTeX Warning: Hyper reference `Plot' on page 696 undefined on input line 40767 . LaTeX Warning: Hyper reference `LabelAt(axis)' on page 696 undefined on input l ine 40767. [696] LaTeX Warning: Hyper reference `SkyFrame' on page 697 undefined on input line 4 0788. [697] LaTeX Warning: Hyper reference `PointList' on page 698 undefined on input line 40808. [698] LaTeX Warning: Hyper reference `astGrid' on page 699 undefined on input line 40 857. LaTeX Warning: Hyper reference `Plot' on page 699 undefined on input line 40857 . [699] LaTeX Warning: Hyper reference `astGrid' on page 700 undefined on input line 40 898. LaTeX Warning: Hyper reference `Escape' on page 700 undefined on input line 408 98. LaTeX Warning: Hyper reference `Plot' on page 700 undefined on input line 40898 . [700] LaTeX Warning: Hyper reference `Plot' on page 701 undefined on input line 40956 . LaTeX Warning: Hyper reference `Frame' on page 701 undefined on input line 4095 6. LaTeX Warning: Hyper reference `FrameSet' on page 701 undefined on input line 4 0956. [701] LaTeX Warning: Hyper reference `astGrid' on page 702 undefined on input line 41 015. LaTeX Warning: Hyper reference `Plot' on page 702 undefined on input line 41015 . [702] LaTeX Warning: Hyper reference `SkyFrame' on page 703 undefined on input line 4 1036. [703] LaTeX Warning: Hyper reference `LutMap' on page 704 undefined on input line 410 71. LaTeX Warning: Hyper reference `WinMap' on page 704 undefined on input line 410 71. LaTeX Warning: Hyper reference `Mapping' on page 704 undefined on input line 41 071. LaTeX Warning: Hyper reference `CmpMap' on page 704 undefined on input line 410 71. LaTeX Warning: Hyper reference `FrameSet' on page 704 undefined on input line 4 1071. LaTeX Warning: Hyper reference `astClone' on page 704 undefined on input line 4 1071. [704] LaTeX Warning: Hyper reference `LutMap' on page 705 undefined on input line 411 06. LaTeX Warning: Hyper reference `CmpMap' on page 705 undefined on input line 411 06. LaTeX Warning: Hyper reference `FrameSet' on page 705 undefined on input line 4 1106. LaTeX Warning: Hyper reference `astClone' on page 705 undefined on input line 4 1106. [705] LaTeX Warning: Hyper reference `astGrid' on page 706 undefined on input line 41 152. LaTeX Warning: Hyper reference `Plot' on page 706 undefined on input line 41152 . LaTeX Warning: Hyper reference `Grid' on page 706 undefined on input line 41152 . [706] LaTeX Warning: Hyper reference `KeyMap' on page 707 undefined on input line 411 90. [707] LaTeX Warning: Hyper reference `Frame' on page 708 undefined on input line 4122 7. LaTeX Warning: Hyper reference `astFindFrame' on page 708 undefined on input li ne 41227. LaTeX Warning: Hyper reference `FrameSet' on page 708 undefined on input line 4 1227. LaTeX Warning: Hyper reference `Current' on page 708 undefined on input line 41 227. [708] LaTeX Warning: Hyper reference `Frame' on page 709 undefined on input line 4129 1. LaTeX Warning: Hyper reference `astFindFrame' on page 709 undefined on input li ne 41291. LaTeX Warning: Hyper reference `Naxes' on page 709 undefined on input line 4129 1. LaTeX Warning: Hyper reference `CmpFrame' on page 709 undefined on input line 4 1291. LaTeX Warning: Hyper reference `MinAxes' on page 709 undefined on input line 41 291. LaTeX Warning: Hyper reference `FrameSet' on page 709 undefined on input line 4 1291. LaTeX Warning: Hyper reference `Current' on page 709 undefined on input line 41 291. LaTeX Warning: Hyper reference `MatchEnd' on page 709 undefined on input line 4 1291. [709] LaTeX Warning: Hyper reference `Moc' on page 710 undefined on input line 41353. LaTeX Warning: Hyper reference `astAddCell' on page 710 undefined on input line 41353. LaTeX Warning: Hyper reference `astAddRegion' on page 710 undefined on input li ne 41353. LaTeX Warning: Hyper reference `Region' on page 710 undefined on input line 413 53. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 710 undefined on inpu t line 41353. LaTeX Warning: Hyper reference `astAddPixelMask$<$X$>$' on page 710 undefined o n input line 41353. LaTeX Warning: Hyper reference `astAddMocData' on page 710 undefined on input l ine 41353. LaTeX Warning: Hyper reference `astAddMocString' on page 710 undefined on input line 41353. LaTeX Warning: Hyper reference `MaxRes' on page 710 undefined on input line 413 53. [710] LaTeX Warning: Hyper reference `MaxOrder' on page 711 undefined on input line 4 1379. LaTeX Warning: Hyper reference `Moc' on page 711 undefined on input line 41379. [711] LaTeX Warning: Hyper reference `Region' on page 712 undefined on input line 414 35. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 712 undefined on inpu t line 41435. LaTeX Warning: Hyper reference `CmpRegion' on page 712 undefined on input line 41435. LaTeX Warning: Hyper reference `Moc' on page 712 undefined on input line 41435. LaTeX Warning: Hyper reference `MaxOrder' on page 712 undefined on input line 4 1435. LaTeX Warning: Hyper reference `Stc' on page 712 undefined on input line 41435. [712] LaTeX Warning: Hyper reference `Frame' on page 713 undefined on input line 4149 7. LaTeX Warning: Hyper reference `astFindFrame' on page 713 undefined on input li ne 41497. LaTeX Warning: Hyper reference `Naxes' on page 713 undefined on input line 4149 7. LaTeX Warning: Hyper reference `CmpFrame' on page 713 undefined on input line 4 1497. LaTeX Warning: Hyper reference `MaxAxes' on page 713 undefined on input line 41 497. LaTeX Warning: Hyper reference `FrameSet' on page 713 undefined on input line 4 1497. LaTeX Warning: Hyper reference `Current' on page 713 undefined on input line 41 497. LaTeX Warning: Hyper reference `MatchEnd' on page 713 undefined on input line 4 1497. [713] LaTeX Warning: Hyper reference `Moc' on page 714 undefined on input line 41542. LaTeX Warning: Hyper reference `astAddRegion' on page 714 undefined on input li ne 41542. LaTeX Warning: Hyper reference `Region' on page 714 undefined on input line 415 42. LaTeX Warning: Hyper reference `MaxOrder' on page 714 undefined on input line 4 1542. LaTeX Warning: Hyper reference `MinRes' on page 714 undefined on input line 415 42. [714] LaTeX Warning: Hyper reference `MinOrder' on page 715 undefined on input line 4 1567. LaTeX Warning: Hyper reference `Moc' on page 715 undefined on input line 41567. [715] LaTeX Warning: Hyper reference `astGrid' on page 716 undefined on input line 41 608. LaTeX Warning: Hyper reference `Plot' on page 716 undefined on input line 41608 . [716] LaTeX Warning: Hyper reference `astGrid' on page 717 undefined on input line 41 655. LaTeX Warning: Hyper reference `Plot' on page 717 undefined on input line 41655 . LaTeX Warning: Hyper reference `MinTick(axis)' on page 717 undefined on input l ine 41655. [717] LaTeX Warning: Hyper reference `Moc' on page 718 undefined on input line 41675. [718] LaTeX Warning: Hyper reference `Moc' on page 719 undefined on input line 41722. LaTeX Warning: Hyper reference `MocChan' on page 719 undefined on input line 41 722. LaTeX Warning: Hyper reference `Object' on page 719 undefined on input line 417 22. LaTeX Warning: Hyper reference `astRead' on page 719 undefined on input line 41 722. LaTeX Warning: Hyper reference `astWrite' on page 719 undefined on input line 4 1722. [719] LaTeX Warning: Hyper reference `Moc' on page 720 undefined on input line 41743. [720] LaTeX Warning: Hyper reference `MocChan' on page 721 undefined on input line 41 767. [721] LaTeX Warning: Hyper reference `Moc' on page 722 undefined on input line 41790. [722] LaTeX Warning: Hyper reference `WcsMap' on page 723 undefined on input line 418 36. LaTeX Warning: Hyper reference `NatLon' on page 723 undefined on input line 418 36. [723] LaTeX Warning: Hyper reference `WcsMap' on page 724 undefined on input line 418 61. LaTeX Warning: Hyper reference `NatLat' on page 724 undefined on input line 418 61. [724] LaTeX Warning: Hyper reference `Frame' on page 725 undefined on input line 4189 5. LaTeX Warning: Hyper reference `FrameSet' on page 725 undefined on input line 4 1895. LaTeX Warning: Hyper reference `Current' on page 725 undefined on input line 41 895. LaTeX Warning: Hyper reference `CmpFrame' on page 725 undefined on input line 4 1895. [725] LaTeX Warning: Hyper reference `FitsChan' on page 726 undefined on input line 4 1916. [726] LaTeX Warning: Hyper reference `astAddColumn' on page 727 undefined on input li ne 41938. LaTeX Warning: Hyper reference `astRemoveColumn' on page 727 undefined on input line 41938. LaTeX Warning: Hyper reference `Table' on page 727 undefined on input line 4193 8. [727] LaTeX Warning: Hyper reference `astNorm' on page 728 undefined on input line 41 967. LaTeX Warning: Hyper reference `SkyRefIs' on page 728 undefined on input line 4 1967. LaTeX Warning: Hyper reference `SkyFrame' on page 728 undefined on input line 4 1967. [728] LaTeX Warning: Hyper reference `Region' on page 729 undefined on input line 419 98. LaTeX Warning: Hyper reference `astNegate' on page 729 undefined on input line 41998. LaTeX Warning: Hyper reference `Closed' on page 729 undefined on input line 419 98. [729] LaTeX Warning: Hyper reference `FrameSet' on page 730 undefined on input line 4 2019. [730] LaTeX Warning: Hyper reference `Mapping' on page 731 undefined on input line 42 068. LaTeX Warning: Hyper reference `CmpMap' on page 731 undefined on input line 420 68. LaTeX Warning: Hyper reference `Nout' on page 731 undefined on input line 42068 . LaTeX Warning: Hyper reference `Invert' on page 731 undefined on input line 420 68. LaTeX Warning: Hyper reference `Frame' on page 731 undefined on input line 4206 8. LaTeX Warning: Hyper reference `Naxes' on page 731 undefined on input line 4206 8. LaTeX Warning: Hyper reference `FrameSet' on page 731 undefined on input line 4 2068. LaTeX Warning: Hyper reference `Base' on page 731 undefined on input line 42068 . [731] LaTeX Warning: Hyper reference `IterInverse' on page 732 undefined on input lin e 42092. LaTeX Warning: Hyper reference `TolInverse' on page 732 undefined on input line 42092. LaTeX Warning: Hyper reference `PolyMap' on page 732 undefined on input line 42 092. [732] LaTeX Warning: Hyper reference `FitsChan' on page 733 undefined on input line 4 2116. LaTeX Warning: Hyper reference `Ncard' on page 733 undefined on input line 4211 6. [733] LaTeX Warning: Hyper reference `Object' on page 734 undefined on input line 421 42. [734] LaTeX Warning: Hyper reference `Plot3D' on page 735 undefined on input line 421 77. LaTeX Warning: Hyper reference `astText' on page 735 undefined on input line 42 177. LaTeX Warning: Hyper reference `astMark' on page 735 undefined on input line 42 177. LaTeX Warning: Hyper reference `Plot' on page 735 undefined on input line 42177 . [735] LaTeX Warning: Hyper reference `Frame' on page 736 undefined on input line 4221 0. [736] LaTeX Warning: Hyper reference `Mapping' on page 737 undefined on input line 42 260. LaTeX Warning: Hyper reference `CmpMap' on page 737 undefined on input line 422 60. LaTeX Warning: Hyper reference `Nin' on page 737 undefined on input line 42260. LaTeX Warning: Hyper reference `Invert' on page 737 undefined on input line 422 60. LaTeX Warning: Hyper reference `Frame' on page 737 undefined on input line 4226 0. LaTeX Warning: Hyper reference `Naxes' on page 737 undefined on input line 4226 0. LaTeX Warning: Hyper reference `FrameSet' on page 737 undefined on input line 4 2260. LaTeX Warning: Hyper reference `Current' on page 737 undefined on input line 42 260. [737] LaTeX Warning: Hyper reference `astAddParameter' on page 738 undefined on input line 42282. LaTeX Warning: Hyper reference `astRemoveParameter' on page 738 undefined on in put line 42282. LaTeX Warning: Hyper reference `Table' on page 738 undefined on input line 4228 2. [738] LaTeX Warning: Hyper reference `Table' on page 739 undefined on input line 4230 5. [739] LaTeX Warning: Hyper reference `astGrid' on page 740 undefined on input line 42 349. LaTeX Warning: Hyper reference `Plot' on page 740 undefined on input line 42349 . LaTeX Warning: Hyper reference `TextLab(axis)' on page 740 undefined on input l ine 42349. [740] LaTeX Warning: Hyper reference `astGrid' on page 741 undefined on input line 42 394. LaTeX Warning: Hyper reference `Plot' on page 741 undefined on input line 42394 . [741] LaTeX Warning: Hyper reference `Object' on page 742 undefined on input line 424 15. [742] LaTeX Warning: Hyper reference `Frame' on page 743 undefined on input line 4245 4. LaTeX Warning: Hyper reference `SpecFrame' on page 743 undefined on input line 42454. LaTeX Warning: Hyper reference `SkyFrame' on page 743 undefined on input line 4 2454. LaTeX Warning: Hyper reference `TimeFrame' on page 743 undefined on input line 42454. LaTeX Warning: Hyper reference `ObsLon' on page 743 undefined on input line 424 54. LaTeX Warning: Hyper reference `Epoch' on page 743 undefined on input line 4245 4. LaTeX Warning: Hyper reference `RefRA' on page 743 undefined on input line 4245 4. LaTeX Warning: Hyper reference `RefDec' on page 743 undefined on input line 424 54. [743] LaTeX Warning: Hyper reference `Frame' on page 744 undefined on input line 4250 1. LaTeX Warning: Hyper reference `SpecFrame' on page 744 undefined on input line 42501. LaTeX Warning: Hyper reference `SkyFrame' on page 744 undefined on input line 4 2501. LaTeX Warning: Hyper reference `TimeFrame' on page 744 undefined on input line 42501. LaTeX Warning: Hyper reference `ObsLon' on page 744 undefined on input line 425 01. LaTeX Warning: Hyper reference `Epoch' on page 744 undefined on input line 4250 1. LaTeX Warning: Hyper reference `RefRA' on page 744 undefined on input line 4250 1. LaTeX Warning: Hyper reference `RefDec' on page 744 undefined on input line 425 01. [744] LaTeX Warning: Hyper reference `ObsLat' on page 745 undefined on input line 425 50. LaTeX Warning: Hyper reference `Frame' on page 745 undefined on input line 4255 0. LaTeX Warning: Hyper reference `SpecFrame' on page 745 undefined on input line 42550. LaTeX Warning: Hyper reference `SkyFrame' on page 745 undefined on input line 4 2550. LaTeX Warning: Hyper reference `TimeFrame' on page 745 undefined on input line 42550. LaTeX Warning: Hyper reference `Epoch' on page 745 undefined on input line 4255 0. LaTeX Warning: Hyper reference `RefRA' on page 745 undefined on input line 4255 0. LaTeX Warning: Hyper reference `RefDec' on page 745 undefined on input line 425 50. [745] LaTeX Warning: Hyper reference `WcsMap' on page 746 undefined on input line 425 76. LaTeX Warning: Hyper reference `PVi_m' on page 746 undefined on input line 4257 6. LaTeX Warning: Hyper reference `astWcsMap' on page 746 undefined on input line 42576. [746] LaTeX Warning: Hyper reference `WcsMap' on page 747 undefined on input line 426 59. LaTeX Warning: Hyper reference `WcsType' on page 747 undefined on input line 42 659. LaTeX Warning: Hyper reference `astWcsMap' on page 747 undefined on input line 42659. LaTeX Warning: Hyper reference `CmpMap' on page 747 undefined on input line 426 59. LaTeX Warning: Hyper reference `FrameSet' on page 747 undefined on input line 4 2659. LaTeX Warning: Hyper reference `astClone' on page 747 undefined on input line 4 2659. [747] LaTeX Warning: Hyper reference `PcdMap' on page 748 undefined on input line 427 02. Overfull \hbox (59.49594pt too wide) in paragraph at lines 42702--42702 \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 748 undefined on input line 427 02. LaTeX Warning: Hyper reference `FrameSet' on page 748 undefined on input line 4 2702. LaTeX Warning: Hyper reference `astClone' on page 748 undefined on input line 4 2702. [748] LaTeX Warning: Hyper reference `Frame' on page 749 undefined on input line 4274 7. LaTeX Warning: Hyper reference `astFindFrame' on page 749 undefined on input li ne 42747. LaTeX Warning: Hyper reference `SkyFrame' on page 749 undefined on input line 4 2747. LaTeX Warning: Hyper reference `FrameSet' on page 749 undefined on input line 4 2747. LaTeX Warning: Hyper reference `Current' on page 749 undefined on input line 42 747. [749] LaTeX Warning: Hyper reference `SphMap' on page 750 undefined on input line 427 76. LaTeX Warning: Hyper reference `CmpMap' on page 750 undefined on input line 427 76. LaTeX Warning: Hyper reference `FrameSet' on page 750 undefined on input line 4 2776. LaTeX Warning: Hyper reference `astClone' on page 750 undefined on input line 4 2776. [750] LaTeX Warning: Hyper reference `FrameSet' on page 751 undefined on input line 4 2819. LaTeX Warning: Hyper reference `PVi_m' on page 751 undefined on input line 4281 9. LaTeX Warning: Hyper reference `FitsChan' on page 751 undefined on input line 4 2819. [751] LaTeX Warning: Hyper reference `Frame' on page 752 undefined on input line 4285 6. LaTeX Warning: Hyper reference `astFindFrame' on page 752 undefined on input li ne 42856. LaTeX Warning: Hyper reference `FrameSet' on page 752 undefined on input line 4 2856. LaTeX Warning: Hyper reference `Current' on page 752 undefined on input line 42 856. [752] LaTeX Warning: Hyper reference `astRead' on page 753 undefined on input line 42 886. LaTeX Warning: Hyper reference `Ident' on page 753 undefined on input line 4288 6. LaTeX Warning: Hyper reference `Mapping' on page 753 undefined on input line 42 886. LaTeX Warning: Hyper reference `ID' on page 753 undefined on input line 42886. LaTeX Warning: Hyper reference `Object' on page 753 undefined on input line 428 86. LaTeX Warning: Hyper reference `astSimplify' on page 753 undefined on input lin e 42886. Underfull \hbox (badness 10000) in paragraph at lines 42886--42886 [753] LaTeX Warning: Hyper reference `WcsMap' on page 754 undefined on input line 429 21. LaTeX Warning: Hyper reference `CmpMap' on page 754 undefined on input line 429 21. LaTeX Warning: Hyper reference `FrameSet' on page 754 undefined on input line 4 2921. LaTeX Warning: Hyper reference `astClone' on page 754 undefined on input line 4 2921. [754] LaTeX Warning: Hyper reference `SkyFrame' on page 755 undefined on input line 4 2952. LaTeX Warning: Hyper reference `Title' on page 755 undefined on input line 4295 2. [755] LaTeX Warning: Hyper reference `Object' on page 756 undefined on input line 429 77. LaTeX Warning: Hyper reference `astClone' on page 756 undefined on input line 4 2977. LaTeX Warning: Hyper reference `astAnnul' on page 756 undefined on input line 4 2977. LaTeX Warning: Hyper reference `astEnd' on page 756 undefined on input line 429 77. [756] LaTeX Warning: Hyper reference `RefRA' on page 757 undefined on input line 4299 8. LaTeX Warning: Hyper reference `SpecFrame' on page 757 undefined on input line 42998. [757] LaTeX Warning: Hyper reference `RefDec' on page 758 undefined on input line 430 47. LaTeX Warning: Hyper reference `astFindFrame' on page 758 undefined on input li ne 43047. LaTeX Warning: Hyper reference `astConvert' on page 758 undefined on input line 43047. LaTeX Warning: Hyper reference `SpecFrame' on page 758 undefined on input line 43047. LaTeX Warning: Hyper reference `CmpFrame' on page 758 undefined on input line 4 3047. LaTeX Warning: Hyper reference `astSetRefPos' on page 758 undefined on input li ne 43047. LaTeX Warning: Hyper reference `astGetRefPos' on page 758 undefined on input li ne 43047. [758] LaTeX Warning: Hyper reference `Region' on page 759 undefined on input line 430 68. LaTeX Warning: Hyper reference `Stc' on page 759 undefined on input line 43068. [759] LaTeX Warning: Hyper reference `Mapping' on page 760 undefined on input line 43 132. LaTeX Warning: Hyper reference `CmpMap' on page 760 undefined on input line 431 32. LaTeX Warning: Hyper reference `Frame' on page 760 undefined on input line 4313 2. LaTeX Warning: Hyper reference `astFormat' on page 760 undefined on input line 43132. LaTeX Warning: Hyper reference `FrameSet' on page 760 undefined on input line 4 3132. LaTeX Warning: Hyper reference `astWrite' on page 760 undefined on input line 4 3132. [760] LaTeX Warning: Hyper reference `Object' on page 761 undefined on input line 431 91. LaTeX Warning: Hyper reference `Strict' on page 761 undefined on input line 431 91. LaTeX Warning: Hyper reference `Report' on page 761 undefined on input line 431 91. LaTeX Warning: Hyper reference `Channel' on page 761 undefined on input line 43 191. LaTeX Warning: Hyper reference `astWrite' on page 761 undefined on input line 4 3191. LaTeX Warning: Hyper reference `FitsChan' on page 761 undefined on input line 4 3191. LaTeX Warning: Hyper reference `Warnings' on page 761 undefined on input line 4 3191. [761] LaTeX Warning: Hyper reference `SpecFrame' on page 762 undefined on input line 43232. [762] LaTeX Warning: Hyper reference `astGrid' on page 763 undefined on input line 43 274. LaTeX Warning: Hyper reference `astPlot3D' on page 763 undefined on input line 43274. LaTeX Warning: Hyper reference `Plot3D' on page 763 undefined on input line 432 74. LaTeX Warning: Hyper reference `Axis' on page 763 undefined on input line 43274 . [763] LaTeX Warning: Hyper reference `MathMap' on page 764 undefined on input line 43 307. [764] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 765 undefined on input li ne 43337. LaTeX Warning: Hyper reference `DSBCentre' on page 765 undefined on input line 43337. LaTeX Warning: Hyper reference `IF' on page 765 undefined on input line 43337. [765] LaTeX Warning: Hyper reference `MathMap' on page 766 undefined on input line 43 393. LaTeX Warning: Hyper reference `Mapping' on page 766 undefined on input line 43 393. LaTeX Warning: Hyper reference `UnitMap' on page 766 undefined on input line 43 393. LaTeX Warning: Hyper reference `astSimplify' on page 766 undefined on input lin e 43393. LaTeX Warning: Hyper reference `SimpIF' on page 766 undefined on input line 433 93. LaTeX Warning: Hyper reference `Invert' on page 766 undefined on input line 433 93. [766] LaTeX Warning: Hyper reference `MathMap' on page 767 undefined on input line 43 449. LaTeX Warning: Hyper reference `Mapping' on page 767 undefined on input line 43 449. LaTeX Warning: Hyper reference `UnitMap' on page 767 undefined on input line 43 449. LaTeX Warning: Hyper reference `astSimplify' on page 767 undefined on input lin e 43449. LaTeX Warning: Hyper reference `SimpFI' on page 767 undefined on input line 434 49. LaTeX Warning: Hyper reference `Invert' on page 767 undefined on input line 434 49. [767] LaTeX Warning: Hyper reference `astSimplify' on page 768 undefined on input lin e 43480. LaTeX Warning: Hyper reference `Polygon' on page 768 undefined on input line 43 480. LaTeX Warning: Hyper reference `Frame' on page 768 undefined on input line 4348 0. LaTeX Warning: Hyper reference `Mapping' on page 768 undefined on input line 43 480. [768] LaTeX Warning: Hyper reference `Channel' on page 769 undefined on input line 43 540. LaTeX Warning: Hyper reference `astWrite' on page 769 undefined on input line 4 3540. LaTeX Warning: Hyper reference `FitsChan' on page 769 undefined on input line 4 3540. LaTeX Warning: Hyper reference `astCopy' on page 769 undefined on input line 43 540. LaTeX Warning: Hyper reference `astShow' on page 769 undefined on input line 43 540. [769] Overfull \hbox (238.94087pt too wide) in paragraph at lines 43592--43592 \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 770 undefined on input line 43 592. LaTeX Warning: Hyper reference `PolyMap' on page 770 undefined on input line 43 592. LaTeX Warning: Hyper reference `FrameSet' on page 770 undefined on input line 4 3592. LaTeX Warning: Hyper reference `MatrixMap' on page 770 undefined on input line 43592. LaTeX Warning: Hyper reference `astWrite' on page 770 undefined on input line 4 3592. LaTeX Warning: Hyper reference `Mapping' on page 770 undefined on input line 43 592. LaTeX Warning: Hyper reference `FitsTol' on page 770 undefined on input line 43 592. LaTeX Warning: Hyper reference `SkyFrame' on page 770 undefined on input line 4 3592. LaTeX Warning: Hyper reference `PolyTan' on page 770 undefined on input line 43 592. LaTeX Warning: Hyper reference `FitsChan' on page 770 undefined on input line 4 3592. [770] LaTeX Warning: Hyper reference `astRead' on page 771 undefined on input line 43 623. Overfull \hbox (190.3857pt too wide) in paragraph at lines 43623--43623 \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 771 undefined on input line 4 3623. [771] LaTeX Warning: Hyper reference `Plot' on page 772 undefined on input line 43667 . [772] LaTeX Warning: Hyper reference `KeyMap' on page 773 undefined on input line 436 98. [773] LaTeX Warning: Hyper reference `Object' on page 774 undefined on input line 437 38. LaTeX Warning: Hyper reference `Channel' on page 774 undefined on input line 43 738. LaTeX Warning: Hyper reference `FitsChan' on page 774 undefined on input line 4 3738. LaTeX Warning: Hyper reference `YamlChan' on page 774 undefined on input line 4 3738. [774] LaTeX Warning: Hyper reference `SkyFrame' on page 775 undefined on input line 4 3819. LaTeX Warning: Hyper reference `System' on page 775 undefined on input line 438 19. LaTeX Warning: Hyper reference `SkyRefIs' on page 775 undefined on input line 4 3819. LaTeX Warning: Hyper reference `LonAxis' on page 775 undefined on input line 43 819. LaTeX Warning: Hyper reference `LatAxis' on page 775 undefined on input line 43 819. LaTeX Warning: Hyper reference `astConvert' on page 775 undefined on input line 43819. LaTeX Warning: Hyper reference `astFindFrame' on page 775 undefined on input li ne 43819. LaTeX Warning: Hyper reference `AlignSystem' on page 775 undefined on input lin e 43819. LaTeX Warning: Hyper reference `AlignOffset' on page 775 undefined on input lin e 43819. [775] LaTeX Warning: Hyper reference `SkyFrame' on page 776 undefined on input line 4 3855. LaTeX Warning: Hyper reference `System' on page 776 undefined on input line 438 55. [776] LaTeX Warning: Hyper reference `SkyRefIs' on page 777 undefined on input line 4 3926. LaTeX Warning: Hyper reference `System' on page 777 undefined on input line 439 26. LaTeX Warning: Hyper reference `SkyFrame' on page 777 undefined on input line 4 3926. LaTeX Warning: Hyper reference `LonAxis' on page 777 undefined on input line 43 926. LaTeX Warning: Hyper reference `LatAxis' on page 777 undefined on input line 43 926. [777] LaTeX Warning: Hyper reference `SkyFrame' on page 778 undefined on input line 4 3977. LaTeX Warning: Hyper reference `Mapping' on page 778 undefined on input line 43 977. LaTeX Warning: Hyper reference `astConvert' on page 778 undefined on input line 43977. LaTeX Warning: Hyper reference `astFindFrame' on page 778 undefined on input li ne 43977. LaTeX Warning: Hyper reference `UnitMap' on page 778 undefined on input line 43 977. LaTeX Warning: Hyper reference `FrameSet' on page 778 undefined on input line 4 3977. LaTeX Warning: Hyper reference `Epoch' on page 778 undefined on input line 4397 7. LaTeX Warning: Hyper reference `AlignSystem' on page 778 undefined on input lin e 43977. [778] LaTeX Warning: Hyper reference `astMapKey' on page 779 undefined on input line 44047. LaTeX Warning: Hyper reference `KeyMap' on page 779 undefined on input line 440 47. [779] LaTeX Warning: Hyper reference `Channel' on page 780 undefined on input line 44 107. LaTeX Warning: Hyper reference `astRead' on page 780 undefined on input line 44 107. LaTeX Warning: Hyper reference `FitsChan' on page 780 undefined on input line 4 4107. LaTeX Warning: Hyper reference `astCopy' on page 780 undefined on input line 44 107. LaTeX Warning: Hyper reference `astShow' on page 780 undefined on input line 44 107. [780] LaTeX Warning: Hyper reference `SourceVel' on page 781 undefined on input line 44156. LaTeX Warning: Hyper reference `SpecFrame' on page 781 undefined on input line 44156. [781] LaTeX Warning: Hyper reference `SourceVel' on page 782 undefined on input line 44188. LaTeX Warning: Hyper reference `StdOfRest' on page 782 undefined on input line 44188. LaTeX Warning: Hyper reference `SpecFrame' on page 782 undefined on input line 44188. [782] LaTeX Warning: Hyper reference `SourceSys' on page 783 undefined on input line 44238. LaTeX Warning: Hyper reference `SourceVRF' on page 783 undefined on input line 44238. LaTeX Warning: Hyper reference `RefRA' on page 783 undefined on input line 4423 8. LaTeX Warning: Hyper reference `RefDec' on page 783 undefined on input line 442 38. LaTeX Warning: Hyper reference `StdOfRest' on page 783 undefined on input line 44238. LaTeX Warning: Hyper reference `SpecFrame' on page 783 undefined on input line 44238. [783] LaTeX Warning: Hyper reference `SpecFrame' on page 784 undefined on input line 44273. LaTeX Warning: Hyper reference `System' on page 784 undefined on input line 442 73. [784] LaTeX Warning: Hyper reference `FluxFrame' on page 785 undefined on input line 44297. LaTeX Warning: Hyper reference `Mapping' on page 785 undefined on input line 44 297. [785] LaTeX Warning: Hyper reference `astRead' on page 786 undefined on input line 44 368. LaTeX Warning: Hyper reference `StcsChan' on page 786 undefined on input line 4 4368. LaTeX Warning: Hyper reference `Region' on page 786 undefined on input line 443 68. LaTeX Warning: Hyper reference `StcsCoords' on page 786 undefined on input line 44368. LaTeX Warning: Hyper reference `StcsProps' on page 786 undefined on input line 44368. LaTeX Warning: Hyper reference `Object' on page 786 undefined on input line 443 68. LaTeX Warning: Hyper reference `KeyMap' on page 786 undefined on input line 443 68. LaTeX Warning: Hyper reference `Prism' on page 786 undefined on input line 4436 8. LaTeX Warning: Hyper reference `astSimplify' on page 786 undefined on input lin e 44368. LaTeX Warning: Hyper reference `TimeFrame' on page 786 undefined on input line 44368. LaTeX Warning: Hyper reference `TimeOrigin' on page 786 undefined on input line 44368. LaTeX Warning: Hyper reference `Epoch' on page 786 undefined on input line 4436 8. [786] LaTeX Warning: Hyper reference `astRead' on page 787 undefined on input line 44 444. LaTeX Warning: Hyper reference `StcsChan' on page 787 undefined on input line 4 4444. LaTeX Warning: Hyper reference `PointList' on page 787 undefined on input line 44444. LaTeX Warning: Hyper reference `StcsArea' on page 787 undefined on input line 4 4444. LaTeX Warning: Hyper reference `StcsProps' on page 787 undefined on input line 44444. LaTeX Warning: Hyper reference `Object' on page 787 undefined on input line 444 44. LaTeX Warning: Hyper reference `KeyMap' on page 787 undefined on input line 444 44. LaTeX Warning: Hyper reference `TimeFrame' on page 787 undefined on input line 44444. LaTeX Warning: Hyper reference `TimeOrigin' on page 787 undefined on input line 44444. LaTeX Warning: Hyper reference `Epoch' on page 787 undefined on input line 4444 4. LaTeX Warning: Hyper reference `Region' on page 787 undefined on input line 444 44. [787] LaTeX Warning: Hyper reference `StcsChan' on page 788 undefined on input line 4 4473. LaTeX Warning: Hyper reference `Indent' on page 788 undefined on input line 444 73. [788] LaTeX Warning: Hyper reference `astRead' on page 789 undefined on input line 44 524. LaTeX Warning: Hyper reference `StcsChan' on page 789 undefined on input line 4 4524. LaTeX Warning: Hyper reference `KeyMap' on page 789 undefined on input line 445 24. LaTeX Warning: Hyper reference `StcsCoords' on page 789 undefined on input line 44524. LaTeX Warning: Hyper reference `StcsArea' on page 789 undefined on input line 4 4524. LaTeX Warning: Hyper reference `Object' on page 789 undefined on input line 445 24. [789] LaTeX Warning: Hyper reference `SpecFrame' on page 790 undefined on input line 44619. LaTeX Warning: Hyper reference `ObsLat' on page 790 undefined on input line 446 19. LaTeX Warning: Hyper reference `ObsLon' on page 790 undefined on input line 446 19. LaTeX Warning: Hyper reference `ObsAlt' on page 790 undefined on input line 446 19. LaTeX Warning: Hyper reference `Epoch' on page 790 undefined on input line 4461 9. LaTeX Warning: Hyper reference `RefRA' on page 790 undefined on input line 4461 9. LaTeX Warning: Hyper reference `RefDec' on page 790 undefined on input line 446 19. LaTeX Warning: Hyper reference `SourceVel' on page 790 undefined on input line 44619. LaTeX Warning: Hyper reference `System' on page 790 undefined on input line 446 19. [790] [791] LaTeX Warning: Hyper reference `Channel' on page 792 undefined on input line 44 659. LaTeX Warning: Hyper reference `astWarnings' on page 792 undefined on input lin e 44659. LaTeX Warning: Hyper reference `YamlChan' on page 792 undefined on input line 4 4659. LaTeX Warning: Hyper reference `Object' on page 792 undefined on input line 446 59. [792] LaTeX Warning: Hyper reference `Plot' on page 793 undefined on input line 44702 . LaTeX Warning: Hyper reference `Border' on page 793 undefined on input line 447 02. [793] LaTeX Warning: Hyper reference `Frame' on page 794 undefined on input line 4476 2. LaTeX Warning: Hyper reference `Domain' on page 794 undefined on input line 447 62. LaTeX Warning: Hyper reference `SkyFrame' on page 794 undefined on input line 4 4762. LaTeX Warning: Hyper reference `TimeFrame' on page 794 undefined on input line 44762. LaTeX Warning: Hyper reference `FrameSet' on page 794 undefined on input line 4 4762. LaTeX Warning: Hyper reference `Current' on page 794 undefined on input line 44 762. [794] LaTeX Warning: Hyper reference `SkyFrame' on page 795 undefined on input line 4 5048. LaTeX Warning: Hyper reference `SpecFrame' on page 795 undefined on input line 45048. LaTeX Warning: Hyper reference `Frame' on page 795 undefined on input line 4504 8. LaTeX Warning: Hyper reference `CmpFrame' on page 795 undefined on input line 4 5048. LaTeX Warning: Hyper reference `FrameSet' on page 795 undefined on input line 4 5048. LaTeX Warning: Hyper reference `Current' on page 795 undefined on input line 45 048. LaTeX Warning: Hyper reference `Epoch' on page 795 undefined on input line 4504 8. LaTeX Warning: Hyper reference `Equinox' on page 795 undefined on input line 45 048. [795] LaTeX Warning: Hyper reference `Mapping' on page 796 undefined on input line 45 048. [796] LaTeX Warning: Hyper reference `astSetActiveUnit' on page 797 undefined on inpu t line 45048. LaTeX Warning: Hyper reference `TimeFrame' on page 797 undefined on input line 45048. LaTeX Warning: Hyper reference `FluxFrame' on page 797 undefined on input line 45048. [797] LaTeX Warning: Hyper reference `FitsChan' on page 798 undefined on input line 4 5132. LaTeX Warning: Hyper reference `astWrite' on page 798 undefined on input line 4 5132. LaTeX Warning: Hyper reference `astRead' on page 798 undefined on input line 45 132. LaTeX Warning: Hyper reference `FrameSet' on page 798 undefined on input line 4 5132. LaTeX Warning: Hyper reference `ForceTab' on page 798 undefined on input line 4 5132. LaTeX Warning: Hyper reference `astGetTables' on page 798 undefined on input li ne 45132. LaTeX Warning: Hyper reference `FitsTable' on page 798 undefined on input line 45132. LaTeX Warning: Hyper reference `astPutTables' on page 798 undefined on input li ne 45132. LaTeX Warning: Hyper reference `astPutTable' on page 798 undefined on input lin e 45132. LaTeX Warning: Hyper reference `astTableSource' on page 798 undefined on input line 45132. [798] LaTeX Warning: Hyper reference `TitleGap' on page 799 undefined on input line 4 5161. LaTeX Warning: Hyper reference `Plot' on page 799 undefined on input line 45161 . [799] LaTeX Warning: Hyper reference `astGrid' on page 800 undefined on input line 45 213. LaTeX Warning: Hyper reference `Plot' on page 800 undefined on input line 45213 . LaTeX Warning: Hyper reference `Labelling' on page 800 undefined on input line 45213. LaTeX Warning: Hyper reference `Label(axis)' on page 800 undefined on input lin e 45213. LaTeX Warning: Hyper reference `Unit(axis)' on page 800 undefined on input line 45213. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 800 undefined on inpu t line 45213. LaTeX Warning: Hyper reference `NumLab(axis)' on page 800 undefined on input li ne 45213. [800] LaTeX Warning: Hyper reference `astGrid' on page 801 undefined on input line 45 268. LaTeX Warning: Hyper reference `Plot' on page 801 undefined on input line 45268 . LaTeX Warning: Hyper reference `TextGapType' on page 801 undefined on input lin e 45268. LaTeX Warning: Hyper reference `Labelling' on page 801 undefined on input line 45268. [801] LaTeX Warning: Hyper reference `astGrid' on page 802 undefined on input line 45 305. LaTeX Warning: Hyper reference `Plot' on page 802 undefined on input line 45305 . LaTeX Warning: Hyper reference `Edge(axis)' on page 802 undefined on input line 45305. LaTeX Warning: Hyper reference `Labelling' on page 802 undefined on input line 45305. [802] LaTeX Warning: Hyper reference `TimeFrame' on page 803 undefined on input line 45386. LaTeX Warning: Hyper reference `System' on page 803 undefined on input line 453 86. LaTeX Warning: Hyper reference `Epoch' on page 803 undefined on input line 4538 6. [803] LaTeX Warning: Hyper reference `TimeFrame' on page 804 undefined on input line 45487. LaTeX Warning: Hyper reference `System' on page 804 undefined on input line 454 87. LaTeX Warning: Hyper reference `Epoch' on page 804 undefined on input line 4548 7. LaTeX Warning: Hyper reference `Dut1' on page 804 undefined on input line 45487 . LaTeX Warning: Hyper reference `Frame' on page 804 undefined on input line 4548 7. LaTeX Warning: Hyper reference `LTOffset' on page 804 undefined on input line 4 5487. Overfull \hbox (146.29462pt too wide) in paragraph at lines 45487--45487 \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 804 undefined on input line 4 5487. [804] [805] LaTeX Warning: Hyper reference `Frame' on page 806 undefined on input line 4553 5. LaTeX Warning: Hyper reference `Naxes' on page 806 undefined on input line 4553 5. LaTeX Warning: Hyper reference `CmpFrame' on page 806 undefined on input line 4 5535. LaTeX Warning: Hyper reference `FrameSet' on page 806 undefined on input line 4 5535. LaTeX Warning: Hyper reference `Current' on page 806 undefined on input line 45 535. [806] LaTeX Warning: Hyper reference `astGrid' on page 807 undefined on input line 45 579. LaTeX Warning: Hyper reference `Plot' on page 807 undefined on input line 45579 . LaTeX Warning: Hyper reference `TextGapType' on page 807 undefined on input lin e 45579. LaTeX Warning: Hyper reference `Plot3D' on page 807 undefined on input line 455 79. LaTeX Warning: Hyper reference `Title' on page 807 undefined on input line 4557 9. [807] LaTeX Warning: Hyper reference `Plot' on page 808 undefined on input line 45607 . [808] LaTeX Warning: Hyper reference `IterInverse' on page 809 undefined on input lin e 45634. LaTeX Warning: Hyper reference `NiterInverse' on page 809 undefined on input li ne 45634. LaTeX Warning: Hyper reference `PolyMap' on page 809 undefined on input line 45 634. [809] LaTeX Warning: Hyper reference `astGrid' on page 810 undefined on input line 45 671. LaTeX Warning: Hyper reference `Frame' on page 810 undefined on input line 4567 1. LaTeX Warning: Hyper reference `SkyFrame' on page 810 undefined on input line 4 5671. [810] LaTeX Warning: Hyper reference `Mapping' on page 811 undefined on input line 45 720. LaTeX Warning: Hyper reference `CmpMap' on page 811 undefined on input line 457 20. LaTeX Warning: Hyper reference `FrameSet' on page 811 undefined on input line 4 5720. LaTeX Warning: Hyper reference `Frame' on page 811 undefined on input line 4572 0. LaTeX Warning: Hyper reference `Base' on page 811 undefined on input line 45720 . LaTeX Warning: Hyper reference `Current' on page 811 undefined on input line 45 720. [811] LaTeX Warning: Hyper reference `Mapping' on page 812 undefined on input line 45 769. LaTeX Warning: Hyper reference `CmpMap' on page 812 undefined on input line 457 69. LaTeX Warning: Hyper reference `FrameSet' on page 812 undefined on input line 4 5769. LaTeX Warning: Hyper reference `Frame' on page 812 undefined on input line 4576 9. LaTeX Warning: Hyper reference `Current' on page 812 undefined on input line 45 769. LaTeX Warning: Hyper reference `Base' on page 812 undefined on input line 45769 . [812] LaTeX Warning: Hyper reference `Frame' on page 813 undefined on input line 4584 0. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 813 undefined on inpu t line 45840. LaTeX Warning: Hyper reference `SkyFrame' on page 813 undefined on input line 4 5840. LaTeX Warning: Hyper reference `astFormat' on page 813 undefined on input line 45840. LaTeX Warning: Hyper reference `SpecFrame' on page 813 undefined on input line 45840. LaTeX Warning: Hyper reference `System' on page 813 undefined on input line 458 40. LaTeX Warning: Hyper reference `TimeFrame' on page 813 undefined on input line 45840. LaTeX Warning: Hyper reference `FrameSet' on page 813 undefined on input line 4 5840. LaTeX Warning: Hyper reference `Current' on page 813 undefined on input line 45 840. [813] LaTeX Warning: Hyper reference `SphMap' on page 814 undefined on input line 459 09. LaTeX Warning: Hyper reference `CmpMap' on page 814 undefined on input line 459 09. LaTeX Warning: Hyper reference `astSimplify' on page 814 undefined on input lin e 45909. LaTeX Warning: Hyper reference `UnitMap' on page 814 undefined on input line 45 909. LaTeX Warning: Hyper reference `FitsChan' on page 814 undefined on input line 4 5909. LaTeX Warning: Hyper reference `FrameSet' on page 814 undefined on input line 4 5909. LaTeX Warning: Hyper reference `astClone' on page 814 undefined on input line 4 5909. [814] LaTeX Warning: Hyper reference `astTest' on page 815 undefined on input line 45 997. LaTeX Warning: Hyper reference `Object' on page 815 undefined on input line 459 97. LaTeX Warning: Hyper reference `FrameSet' on page 815 undefined on input line 4 5997. LaTeX Warning: Hyper reference `Frame' on page 815 undefined on input line 4599 7. LaTeX Warning: Hyper reference `CmpFrame' on page 815 undefined on input line 4 5997. LaTeX Warning: Hyper reference `Region' on page 815 undefined on input line 459 97. LaTeX Warning: Hyper reference `Epoch' on page 815 undefined on input line 4599 7. LaTeX Warning: Hyper reference `ObsLat' on page 815 undefined on input line 459 97. LaTeX Warning: Hyper reference `ObsLon' on page 815 undefined on input line 459 97. LaTeX Warning: Hyper reference `SkyFrame' on page 815 undefined on input line 4 5997. LaTeX Warning: Hyper reference `Equinox' on page 815 undefined on input line 45 997. LaTeX Warning: Hyper reference `SpecFrame' on page 815 undefined on input line 45997. LaTeX Warning: Hyper reference `RefRA' on page 815 undefined on input line 4599 7. LaTeX Warning: Hyper reference `RefDec' on page 815 undefined on input line 459 97. LaTeX Warning: Hyper reference `RestFreq' on page 815 undefined on input line 4 5997. LaTeX Warning: Hyper reference `SourceVel' on page 815 undefined on input line 45997. LaTeX Warning: Hyper reference `StdOfRest' on page 815 undefined on input line 45997. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 815 undefined on input li ne 45997. LaTeX Warning: Hyper reference `ImagFreq' on page 815 undefined on input line 4 5997. LaTeX Warning: Hyper reference `DSBCentre' on page 815 undefined on input line 45997. LaTeX Warning: Hyper reference `IF' on page 815 undefined on input line 45997. [815] LaTeX Warning: Hyper reference `Mapping' on page 816 undefined on input line 46 099. LaTeX Warning: Hyper reference `Frame' on page 816 undefined on input line 4609 9. LaTeX Warning: Hyper reference `FrameSet' on page 816 undefined on input line 4 6099. LaTeX Warning: Hyper reference `astRemapFrame' on page 816 undefined on input l ine 46099. LaTeX Warning: Hyper reference `Domain' on page 816 undefined on input line 460 99. LaTeX Warning: Hyper reference `SkyFrame' on page 816 undefined on input line 4 6099. LaTeX Warning: Hyper reference `astAddFrame' on page 816 undefined on input lin e 46099. LaTeX Warning: Hyper reference `astAddVariant' on page 816 undefined on input l ine 46099. LaTeX Warning: Hyper reference `astMirrorVariants' on page 816 undefined on inp ut line 46099. LaTeX Warning: Hyper reference `AllVariants' on page 816 undefined on input lin e 46099. [816] [817] Underfull \hbox (badness 10000) in paragraph at lines 46120--46120 [818] LaTeX Warning: Hyper reference `Object' on page 819 undefined on input line 461 63. LaTeX Warning: Hyper reference `FitsChan' on page 819 undefined on input line 4 6163. LaTeX Warning: Hyper reference `AllWarnings' on page 819 undefined on input lin e 46163. LaTeX Warning: Hyper reference `astFindFits' on page 819 undefined on input lin e 46163. LaTeX Warning: Hyper reference `astRead' on page 819 undefined on input line 46 163. LaTeX Warning: Hyper reference `astWrite' on page 819 undefined on input line 4 6163. LaTeX Warning: Hyper reference `astDelFits' on page 819 undefined on input line 46163. LaTeX Warning: Hyper reference `Channel' on page 819 undefined on input line 46 163. LaTeX Warning: Hyper reference `astWarnings' on page 819 undefined on input lin e 46163. [819] LaTeX Warning: Hyper reference `WcsMap' on page 820 undefined on input line 461 90. LaTeX Warning: Hyper reference `astWcsMap' on page 820 undefined on input line 46190. [820] LaTeX Warning: Hyper reference `WcsMap' on page 821 undefined on input line 462 29. LaTeX Warning: Hyper reference `astWcsMap' on page 821 undefined on input line 46229. [821] LaTeX Warning: Hyper reference `Plot' on page 822 undefined on input line 46275 . LaTeX Warning: Hyper reference `Border' on page 822 undefined on input line 462 75. [822] LaTeX Warning: Hyper reference `XmlChan' on page 823 undefined on input line 46 470. LaTeX Warning: Hyper reference `astWrite' on page 823 undefined on input line 4 6470. LaTeX Warning: Hyper reference `Object' on page 823 undefined on input line 464 70. LaTeX Warning: Hyper reference `FitsChan' on page 823 undefined on input line 4 6470. LaTeX Warning: Hyper reference `Channel' on page 823 undefined on input line 46 470. LaTeX Warning: Hyper reference `StcsChan' on page 823 undefined on input line 4 6470. LaTeX Warning: Hyper reference `astRead' on page 823 undefined on input line 46 470. [823] LaTeX Warning: Hyper reference `Stc' on page 824 undefined on input line 46470. LaTeX Warning: Hyper reference `StcResourceProfile' on page 824 undefined on in put line 46470. LaTeX Warning: Hyper reference `StcSearchLocation' on page 824 undefined on inp ut line 46470. LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 824 undefined on input line 46470. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 824 undefined on in put line 46470. LaTeX Warning: Hyper reference `TimeFrame' on page 824 undefined on input line 46470. LaTeX Warning: Hyper reference `Frame' on page 824 undefined on input line 4647 0. LaTeX Warning: Hyper reference `Domain' on page 824 undefined on input line 464 70. LaTeX Warning: Hyper reference `SkyFrame' on page 824 undefined on input line 4 6470. LaTeX Warning: Hyper reference `Region' on page 824 undefined on input line 464 70. LaTeX Warning: Hyper reference `Polygon' on page 824 undefined on input line 46 470. [824] LaTeX Warning: Hyper reference `XmlChan' on page 825 undefined on input line 46 495. [825] LaTeX Warning: Hyper reference `Object' on page 826 undefined on input line 465 24. LaTeX Warning: Hyper reference `XmlChan' on page 826 undefined on input line 46 524. [826] LaTeX Warning: Hyper reference `YamlChan' on page 827 undefined on input line 4 6624. LaTeX Warning: Hyper reference `astWrite' on page 827 undefined on input line 4 6624. LaTeX Warning: Hyper reference `Object' on page 827 undefined on input line 466 24. LaTeX Warning: Hyper reference `SkyFrame' on page 827 undefined on input line 4 6624. LaTeX Warning: Hyper reference `Mapping' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `CmpMap' on page 827 undefined on input line 466 24. LaTeX Warning: Hyper reference `TranMap' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `UnitMap' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `ZoomMap' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `ShiftMap' on page 827 undefined on input line 4 6624. LaTeX Warning: Hyper reference `WinMap' on page 827 undefined on input line 466 24. LaTeX Warning: Hyper reference `MatrixMap' on page 827 undefined on input line 46624. LaTeX Warning: Hyper reference `PermMap' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `WcsMap' on page 827 undefined on input line 466 24. LaTeX Warning: Hyper reference `PolyMap' on page 827 undefined on input line 46 624. LaTeX Warning: Hyper reference `ChebyMap' on page 827 undefined on input line 4 6624. [827] LaTeX Warning: Hyper reference `ZoomMap' on page 828 undefined on input line 46 674. LaTeX Warning: Hyper reference `astInvert' on page 828 undefined on input line 46674. LaTeX Warning: Hyper reference `Mapping' on page 828 undefined on input line 46 674. LaTeX Warning: Hyper reference `Invert' on page 828 undefined on input line 466 74. LaTeX Warning: Hyper reference `CmpMap' on page 828 undefined on input line 466 74. LaTeX Warning: Hyper reference `FrameSet' on page 828 undefined on input line 4 6674. LaTeX Warning: Hyper reference `astClone' on page 828 undefined on input line 4 6674. [828] [829] LaTeX Warning: Hyper reference `Frame' on page 830 undefined on input line 4669 9. LaTeX Warning: Hyper reference `astWrite' on page 830 undefined on input line 4 6699. LaTeX Warning: Hyper reference `Object' on page 830 undefined on input line 466 99. [830] LaTeX Warning: Hyper reference `Region' on page 831 undefined on input line 467 36. LaTeX Warning: Hyper reference `Frame' on page 831 undefined on input line 4673 6. LaTeX Warning: Hyper reference `Interval' on page 831 undefined on input line 4 6736. LaTeX Warning: Hyper reference `SkyFrame' on page 831 undefined on input line 4 6736. LaTeX Warning: Hyper reference `Polygon' on page 831 undefined on input line 46 736. LaTeX Warning: Hyper reference `astBox' on page 831 undefined on input line 467 36. [831] LaTeX Warning: Hyper reference `Object' on page 832 undefined on input line 468 18. LaTeX Warning: Hyper reference `SinkFile' on page 832 undefined on input line 4 6818. LaTeX Warning: Hyper reference `SourceFile' on page 832 undefined on input line 46818. LaTeX Warning: Hyper reference `astChannel' on page 832 undefined on input line 46818. LaTeX Warning: Hyper reference `Comment' on page 832 undefined on input line 46 818. LaTeX Warning: Hyper reference `Full' on page 832 undefined on input line 46818 . LaTeX Warning: Hyper reference `Indent' on page 832 undefined on input line 468 18. LaTeX Warning: Hyper reference `ReportLevel' on page 832 undefined on input lin e 46818. LaTeX Warning: Hyper reference `SinkFile' on page 832 undefined on input line 4 6818. LaTeX Warning: Hyper reference `Skip' on page 832 undefined on input line 46818 . LaTeX Warning: Hyper reference `SourceFile' on page 832 undefined on input line 46818. LaTeX Warning: Hyper reference `Strict' on page 832 undefined on input line 468 18. LaTeX Warning: Hyper reference `astWarnings' on page 832 undefined on input lin e 46818. LaTeX Warning: Hyper reference `astPutChannelData' on page 832 undefined on inp ut line 46818. LaTeX Warning: Hyper reference `astRead' on page 832 undefined on input line 46 818. LaTeX Warning: Hyper reference `astWrite' on page 832 undefined on input line 4 6818. [832] LaTeX Warning: Hyper reference `Mapping' on page 833 undefined on input line 46 905. LaTeX Warning: Hyper reference `astPolyTran' on page 833 undefined on input lin e 46905. LaTeX Warning: Hyper reference `PolyMap' on page 833 undefined on input line 46 905. LaTeX Warning: Hyper reference `astChebyMap' on page 833 undefined on input lin e 46905. LaTeX Warning: Hyper reference `astChebyDomain' on page 833 undefined on input line 46905. [833] LaTeX Warning: Hyper reference `Region' on page 834 undefined on input line 469 41. LaTeX Warning: Hyper reference `Frame' on page 834 undefined on input line 4694 1. LaTeX Warning: Hyper reference `astCircle' on page 834 undefined on input line 46941. LaTeX Warning: Hyper reference `astCirclePars' on page 834 undefined on input l ine 46941. [834] LaTeX Warning: Hyper reference `Frame' on page 835 undefined on input line 4699 6. LaTeX Warning: Hyper reference `Mapping' on page 835 undefined on input line 46 996. LaTeX Warning: Hyper reference `UnitMap' on page 835 undefined on input line 46 996. LaTeX Warning: Hyper reference `Region' on page 835 undefined on input line 469 96. LaTeX Warning: Hyper reference `astCmpFrame' on page 835 undefined on input lin e 46996. LaTeX Warning: Hyper reference `SpecFrame' on page 835 undefined on input line 46996. LaTeX Warning: Hyper reference `SkyFrame' on page 835 undefined on input line 4 6996. LaTeX Warning: Hyper reference `Equinox' on page 835 undefined on input line 46 996. LaTeX Warning: Hyper reference `RestFreq' on page 835 undefined on input line 4 6996. [835] LaTeX Warning: Hyper reference `Mapping' on page 836 undefined on input line 47 037. LaTeX Warning: Hyper reference `astCmpMap' on page 836 undefined on input line 47037. [836] LaTeX Warning: Hyper reference `Region' on page 837 undefined on input line 470 97. LaTeX Warning: Hyper reference `Frame' on page 837 undefined on input line 4709 7. LaTeX Warning: Hyper reference `astConvert' on page 837 undefined on input line 47097. LaTeX Warning: Hyper reference `Mapping' on page 837 undefined on input line 47 097. LaTeX Warning: Hyper reference `SkyFrame' on page 837 undefined on input line 4 7097. LaTeX Warning: Hyper reference `astCmpRegion' on page 837 undefined on input li ne 47097. [837] LaTeX Warning: Hyper reference `SpecFrame' on page 838 undefined on input line 47166. LaTeX Warning: Hyper reference `SideBand' on page 838 undefined on input line 4 7166. LaTeX Warning: Hyper reference `IF' on page 838 undefined on input line 47166. LaTeX Warning: Hyper reference `astDSBSpecFrame' on page 838 undefined on input line 47166. LaTeX Warning: Hyper reference `AlignSideBand' on page 838 undefined on input l ine 47166. LaTeX Warning: Hyper reference `DSBCentre' on page 838 undefined on input line 47166. LaTeX Warning: Hyper reference `IF' on page 838 undefined on input line 47166. LaTeX Warning: Hyper reference `ImagFreq' on page 838 undefined on input line 4 7166. LaTeX Warning: Hyper reference `SideBand' on page 838 undefined on input line 4 7166. [838] LaTeX Warning: Hyper reference `Mapping' on page 839 undefined on input line 47 213. LaTeX Warning: Hyper reference `FrameSet' on page 839 undefined on input line 4 7213. LaTeX Warning: Hyper reference `astRead' on page 839 undefined on input line 47 213. LaTeX Warning: Hyper reference `FitsChan' on page 839 undefined on input line 4 7213. LaTeX Warning: Hyper reference `Encoding' on page 839 undefined on input line 4 7213. [839] LaTeX Warning: Hyper reference `Region' on page 840 undefined on input line 472 49. LaTeX Warning: Hyper reference `Frame' on page 840 undefined on input line 4724 9. LaTeX Warning: Hyper reference `astEllipse' on page 840 undefined on input line 47249. LaTeX Warning: Hyper reference `astEllipsePars' on page 840 undefined on input line 47249. [840] LaTeX Warning: Hyper reference `Channel' on page 841 undefined on input line 47 488. LaTeX Warning: Hyper reference `System' on page 841 undefined on input line 474 88. LaTeX Warning: Hyper reference `Object' on page 841 undefined on input line 474 88. LaTeX Warning: Hyper reference `astWrite' on page 841 undefined on input line 4 7488. LaTeX Warning: Hyper reference `Card' on page 841 undefined on input line 47488 . LaTeX Warning: Hyper reference `astFindFits' on page 841 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astPutFits' on page 841 undefined on input line 47488. LaTeX Warning: Hyper reference `astPutCards' on page 841 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 841 undefined on inp ut line 47488. LaTeX Warning: Hyper reference `astDelFits' on page 841 undefined on input line 47488. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 841 undefined on inp ut line 47488. LaTeX Warning: Hyper reference `SourceFile' on page 841 undefined on input line 47488. LaTeX Warning: Hyper reference `SinkFile' on page 841 undefined on input line 4 7488. LaTeX Warning: Hyper reference `astRead' on page 841 undefined on input line 47 488. LaTeX Warning: Hyper reference `Encoding' on page 841 undefined on input line 4 7488. LaTeX Warning: Hyper reference `astRetainFits' on page 841 undefined on input l ine 47488. [841] LaTeX Warning: Hyper reference `astFitsChan' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `AllWarnings' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `Card' on page 842 undefined on input line 47488 . LaTeX Warning: Hyper reference `CardComm' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `CardName' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `CardType' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `CarLin' on page 842 undefined on input line 474 88. LaTeX Warning: Hyper reference `CDMatrix' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `Clean' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `DefB1950' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `Encoding' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 842 undefined on input l ine 47488. LaTeX Warning: Hyper reference `FitsDigits' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `ForceTab' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `Iwc' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `Frame' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `Ncard' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `Nkey' on page 842 undefined on input line 47488 . LaTeX Warning: Hyper reference `PolyTan' on page 842 undefined on input line 47 488. LaTeX Warning: Hyper reference `PVi_m' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `SipReplace' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `SipOK' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `SipReplace' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `TabOK' on page 842 undefined on input line 4748 8. LaTeX Warning: Hyper reference `Warnings' on page 842 undefined on input line 4 7488. LaTeX Warning: Hyper reference `astDelFits' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `astEmptyFits' on page 842 undefined on input li ne 47488. LaTeX Warning: Hyper reference `astFindFits' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astGetFits$<$X$>$' on page 842 undefined on inp ut line 47488. LaTeX Warning: Hyper reference `astGetTables' on page 842 undefined on input li ne 47488. LaTeX Warning: Hyper reference `astPurgeWCS' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astPutCards' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astPutFits' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `astPutTable' on page 842 undefined on input lin e 47488. LaTeX Warning: Hyper reference `FitsTable' on page 842 undefined on input line 47488. LaTeX Warning: Hyper reference `astPutTables' on page 842 undefined on input li ne 47488. LaTeX Warning: Hyper reference `astReadFits' on page 842 undefined on input lin e 47488. [842] LaTeX Warning: Hyper reference `astRemoveTables' on page 843 undefined on input line 47488. LaTeX Warning: Hyper reference `astRetainFits' on page 843 undefined on input l ine 47488. LaTeX Warning: Hyper reference `astSetFits$<$X$>$' on page 843 undefined on inp ut line 47488. LaTeX Warning: Hyper reference `astShowFits' on page 843 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astTableSource' on page 843 undefined on input line 47488. LaTeX Warning: Hyper reference `astTestFits' on page 843 undefined on input lin e 47488. LaTeX Warning: Hyper reference `astWriteFits' on page 843 undefined on input li ne 47488. [843] LaTeX Warning: Hyper reference `Table' on page 844 undefined on input line 4755 3. LaTeX Warning: Hyper reference `FitsChan' on page 844 undefined on input line 4 7553. LaTeX Warning: Hyper reference `astFitsTable' on page 844 undefined on input li ne 47553. LaTeX Warning: Hyper reference `astColumnNull' on page 844 undefined on input l ine 47553. LaTeX Warning: Hyper reference `astColumnSize' on page 844 undefined on input l ine 47553. LaTeX Warning: Hyper reference `astGetColumnData' on page 844 undefined on inpu t line 47553. LaTeX Warning: Hyper reference `astGetTableHeader' on page 844 undefined on inp ut line 47553. LaTeX Warning: Hyper reference `astPutColumnData' on page 844 undefined on inpu t line 47553. LaTeX Warning: Hyper reference `astPutTableHeader' on page 844 undefined on inp ut line 47553. [844] LaTeX Warning: Hyper reference `Frame' on page 845 undefined on input line 4759 7. LaTeX Warning: Hyper reference `System' on page 845 undefined on input line 475 97. LaTeX Warning: Hyper reference `SpecVal' on page 845 undefined on input line 47 597. LaTeX Warning: Hyper reference `astFluxFrame' on page 845 undefined on input li ne 47597. LaTeX Warning: Hyper reference `SpecVal' on page 845 undefined on input line 47 597. [845] LaTeX Warning: Hyper reference `Title' on page 846 undefined on input line 4779 6. LaTeX Warning: Hyper reference `astFrame' on page 846 undefined on input line 4 7796. LaTeX Warning: Hyper reference `Mapping' on page 846 undefined on input line 47 796. LaTeX Warning: Hyper reference `UnitMap' on page 846 undefined on input line 47 796. LaTeX Warning: Hyper reference `Nin' on page 846 undefined on input line 47796. LaTeX Warning: Hyper reference `Nout' on page 846 undefined on input line 47796 . LaTeX Warning: Hyper reference `AlignSystem' on page 846 undefined on input lin e 47796. LaTeX Warning: Hyper reference `Bottom(axis)' on page 846 undefined on input li ne 47796. LaTeX Warning: Hyper reference `Digits/Digits(axis)' on page 846 undefined on i nput line 47796. LaTeX Warning: Hyper reference `Direction(axis)' on page 846 undefined on input line 47796. LaTeX Warning: Hyper reference `Domain' on page 846 undefined on input line 477 96. LaTeX Warning: Hyper reference `Dtai' on page 846 undefined on input line 47796 . LaTeX Warning: Hyper reference `Dut1' on page 846 undefined on input line 47796 . LaTeX Warning: Hyper reference `Epoch' on page 846 undefined on input line 4779 6. LaTeX Warning: Hyper reference `Format(axis)' on page 846 undefined on input li ne 47796. LaTeX Warning: Hyper reference `InternalUnit(axis)' on page 846 undefined on in put line 47796. LaTeX Warning: Hyper reference `Label(axis)' on page 846 undefined on input lin e 47796. LaTeX Warning: Hyper reference `Axis' on page 846 undefined on input line 47796 . LaTeX Warning: Hyper reference `MatchEnd' on page 846 undefined on input line 4 7796. LaTeX Warning: Hyper reference `MaxAxes' on page 846 undefined on input line 47 796. LaTeX Warning: Hyper reference `MinAxes' on page 846 undefined on input line 47 796. LaTeX Warning: Hyper reference `Naxes' on page 846 undefined on input line 4779 6. LaTeX Warning: Hyper reference `NormUnit(axis)' on page 846 undefined on input line 47796. LaTeX Warning: Hyper reference `ObsAlt' on page 846 undefined on input line 477 96. LaTeX Warning: Hyper reference `ObsLat' on page 846 undefined on input line 477 96. LaTeX Warning: Hyper reference `ObsLon' on page 846 undefined on input line 477 96. [846] LaTeX Warning: Hyper reference `Permute' on page 847 undefined on input line 47 796. LaTeX Warning: Hyper reference `PreserveAxes' on page 847 undefined on input li ne 47796. LaTeX Warning: Hyper reference `Symbol(axis)' on page 847 undefined on input li ne 47796. LaTeX Warning: Hyper reference `System' on page 847 undefined on input line 477 96. LaTeX Warning: Hyper reference `Title' on page 847 undefined on input line 4779 6. LaTeX Warning: Hyper reference `Top(axis)' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `Unit(axis)' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astAngle' on page 847 undefined on input line 4 7796. LaTeX Warning: Hyper reference `astAxAngle' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astAxDistance' on page 847 undefined on input l ine 47796. LaTeX Warning: Hyper reference `astAxNorm' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astAxOffset' on page 847 undefined on input lin e 47796. LaTeX Warning: Hyper reference `astConvert' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astDistance' on page 847 undefined on input lin e 47796. LaTeX Warning: Hyper reference `astFindFrame' on page 847 undefined on input li ne 47796. LaTeX Warning: Hyper reference `astFormat' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astGetActiveUnit' on page 847 undefined on inpu t line 47796. LaTeX Warning: Hyper reference `astIntersect' on page 847 undefined on input li ne 47796. LaTeX Warning: Hyper reference `astMatchAxes' on page 847 undefined on input li ne 47796. LaTeX Warning: Hyper reference `astNorm' on page 847 undefined on input line 47 796. LaTeX Warning: Hyper reference `astOffset' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astOffset2' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astPermAxes' on page 847 undefined on input lin e 47796. LaTeX Warning: Hyper reference `astPickAxes' on page 847 undefined on input lin e 47796. LaTeX Warning: Hyper reference `astResolve' on page 847 undefined on input line 47796. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 847 undefined on inpu t line 47796. LaTeX Warning: Hyper reference `astUnformat' on page 847 undefined on input lin e 47796. [847] LaTeX Warning: Hyper reference `Mapping' on page 848 undefined on input line 47 919. LaTeX Warning: Hyper reference `Frame' on page 848 undefined on input line 4791 9. LaTeX Warning: Hyper reference `Base' on page 848 undefined on input line 47919 . LaTeX Warning: Hyper reference `Current' on page 848 undefined on input line 47 919. LaTeX Warning: Hyper reference `Title' on page 848 undefined on input line 4791 9. LaTeX Warning: Hyper reference `astInvert' on page 848 undefined on input line 47919. LaTeX Warning: Hyper reference `Region' on page 848 undefined on input line 479 19. LaTeX Warning: Hyper reference `astFrameSet' on page 848 undefined on input lin e 47919. LaTeX Warning: Hyper reference `AllVariants' on page 848 undefined on input lin e 47919. LaTeX Warning: Hyper reference `Base' on page 848 undefined on input line 47919 . LaTeX Warning: Hyper reference `Current' on page 848 undefined on input line 47 919. LaTeX Warning: Hyper reference `Nframe' on page 848 undefined on input line 479 19. LaTeX Warning: Hyper reference `Variant' on page 848 undefined on input line 47 919. LaTeX Warning: Hyper reference `Equinox' on page 848 undefined on input line 47 919. LaTeX Warning: Hyper reference `SkyFrame' on page 848 undefined on input line 4 7919. [848] LaTeX Warning: Hyper reference `astAddFrame' on page 849 undefined on input lin e 47919. LaTeX Warning: Hyper reference `astAddVariant' on page 849 undefined on input l ine 47919. LaTeX Warning: Hyper reference `astGetFrame' on page 849 undefined on input lin e 47919. LaTeX Warning: Hyper reference `astGetMapping' on page 849 undefined on input l ine 47919. LaTeX Warning: Hyper reference `astMirrorVariants' on page 849 undefined on inp ut line 47919. LaTeX Warning: Hyper reference `astRemapFrame' on page 849 undefined on input l ine 47919. LaTeX Warning: Hyper reference `astRemoveFrame' on page 849 undefined on input line 47919. [849] LaTeX Warning: Hyper reference `Mapping' on page 850 undefined on input line 47 990. LaTeX Warning: Hyper reference `GrismWaveR' on page 850 undefined on input line 47990. LaTeX Warning: Hyper reference `GrismNRP' on page 850 undefined on input line 4 7990. LaTeX Warning: Hyper reference `GrismG' on page 850 undefined on input line 479 90. LaTeX Warning: Hyper reference `astGrismMap' on page 850 undefined on input lin e 47990. LaTeX Warning: Hyper reference `GrismNR' on page 850 undefined on input line 47 990. LaTeX Warning: Hyper reference `GrismNRP' on page 850 undefined on input line 4 7990. LaTeX Warning: Hyper reference `GrismWaveR' on page 850 undefined on input line 47990. LaTeX Warning: Hyper reference `GrismAlpha' on page 850 undefined on input line 47990. LaTeX Warning: Hyper reference `GrismG' on page 850 undefined on input line 479 90. LaTeX Warning: Hyper reference `GrismM' on page 850 undefined on input line 479 90. LaTeX Warning: Hyper reference `GrismEps' on page 850 undefined on input line 4 7990. LaTeX Warning: Hyper reference `GrismTheta' on page 850 undefined on input line 47990. [850] LaTeX Warning: Hyper reference `Region' on page 851 undefined on input line 480 32. LaTeX Warning: Hyper reference `Frame' on page 851 undefined on input line 4803 2. LaTeX Warning: Hyper reference `SkyFrame' on page 851 undefined on input line 4 8032. LaTeX Warning: Hyper reference `Box' on page 851 undefined on input line 48032. LaTeX Warning: Hyper reference `astInterval' on page 851 undefined on input lin e 48032. [851] LaTeX Warning: Hyper reference `Mapping' on page 852 undefined on input line 48 081. LaTeX Warning: Hyper reference `astIntraReg' on page 852 undefined on input lin e 48081. LaTeX Warning: Hyper reference `astIntraMap' on page 852 undefined on input lin e 48081. LaTeX Warning: Hyper reference `IntraFlag' on page 852 undefined on input line 48081. [852] LaTeX Warning: Hyper reference `KeyCase' on page 853 undefined on input line 48 202. LaTeX Warning: Hyper reference `Object' on page 853 undefined on input line 482 02. LaTeX Warning: Hyper reference `Mapping' on page 853 undefined on input line 48 202. LaTeX Warning: Hyper reference `astKeyMap' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `KeyCase' on page 853 undefined on input line 48 202. LaTeX Warning: Hyper reference `KeyError' on page 853 undefined on input line 4 8202. LaTeX Warning: Hyper reference `Report' on page 853 undefined on input line 482 02. LaTeX Warning: Hyper reference `SizeGuess' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `SortBy' on page 853 undefined on input line 482 02. LaTeX Warning: Hyper reference `MapLocked' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapCopy' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapCopyEntry' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapDefined' on page 853 undefined on input l ine 48202. LaTeX Warning: Hyper reference `astMapGet0$<$X$>$' on page 853 undefined on inp ut line 48202. LaTeX Warning: Hyper reference `astMapGet1$<$X$>$' on page 853 undefined on inp ut line 48202. LaTeX Warning: Hyper reference `astMapGetC' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapGetElem$<$X$>$' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapHasKey' on page 853 undefined on input li ne 48202. LaTeX Warning: Hyper reference `astMapKey' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapLenC' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapLength' on page 853 undefined on input li ne 48202. LaTeX Warning: Hyper reference `astMapPut0$<$X$>$' on page 853 undefined on inp ut line 48202. LaTeX Warning: Hyper reference `astMapPut1$<$X$>$' on page 853 undefined on inp ut line 48202. LaTeX Warning: Hyper reference `astMapPutElem$<$X$>$' on page 853 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapPutU' on page 853 undefined on input line 48202. [853] LaTeX Warning: Hyper reference `astMapRemove' on page 854 undefined on input li ne 48202. LaTeX Warning: Hyper reference `astMapRename' on page 854 undefined on input li ne 48202. LaTeX Warning: Hyper reference `astMapSize' on page 854 undefined on input line 48202. LaTeX Warning: Hyper reference `astMapType' on page 854 undefined on input line 48202. [854] LaTeX Warning: Hyper reference `Mapping' on page 855 undefined on input line 48 261. LaTeX Warning: Hyper reference `astLutMap' on page 855 undefined on input line 48261. LaTeX Warning: Hyper reference `LutEpsilon' on page 855 undefined on input line 48261. LaTeX Warning: Hyper reference `LutInterp' on page 855 undefined on input line 48261. [855] LaTeX Warning: Hyper reference `Object' on page 856 undefined on input line 483 80. LaTeX Warning: Hyper reference `Invert' on page 856 undefined on input line 483 80. LaTeX Warning: Hyper reference `IsLinear' on page 856 undefined on input line 4 8380. LaTeX Warning: Hyper reference `IsSimple' on page 856 undefined on input line 4 8380. LaTeX Warning: Hyper reference `Nin' on page 856 undefined on input line 48380. LaTeX Warning: Hyper reference `Nout' on page 856 undefined on input line 48380 . LaTeX Warning: Hyper reference `Report' on page 856 undefined on input line 483 80. LaTeX Warning: Hyper reference `TranForward' on page 856 undefined on input lin e 48380. LaTeX Warning: Hyper reference `TranInverse' on page 856 undefined on input lin e 48380. LaTeX Warning: Hyper reference `astDecompose' on page 856 undefined on input li ne 48380. LaTeX Warning: Hyper reference `astTranGrid' on page 856 undefined on input lin e 48380. LaTeX Warning: Hyper reference `astInvert' on page 856 undefined on input line 48380. LaTeX Warning: Hyper reference `astLinearApprox' on page 856 undefined on input line 48380. LaTeX Warning: Hyper reference `astMapBox' on page 856 undefined on input line 48380. LaTeX Warning: Hyper reference `astMapSplit' on page 856 undefined on input lin e 48380. LaTeX Warning: Hyper reference `astQuadApprox' on page 856 undefined on input l ine 48380. LaTeX Warning: Hyper reference `astRate' on page 856 undefined on input line 48 380. LaTeX Warning: Hyper reference `astRebin$<$X$>$' on page 856 undefined on input line 48380. LaTeX Warning: Hyper reference `astRebinSeq$<$X$>$' on page 856 undefined on in put line 48380. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 856 undefined on in put line 48380. LaTeX Warning: Hyper reference `astRemoveRegions' on page 856 undefined on inpu t line 48380. LaTeX Warning: Hyper reference `astSimplify' on page 856 undefined on input lin e 48380. LaTeX Warning: Hyper reference `astTran1' on page 856 undefined on input line 4 8380. [856] LaTeX Warning: Hyper reference `astTran2' on page 857 undefined on input line 4 8380. LaTeX Warning: Hyper reference `astTranN' on page 857 undefined on input line 4 8380. LaTeX Warning: Hyper reference `astTranP' on page 857 undefined on input line 4 8380. [857] LaTeX Warning: Hyper reference `Mapping' on page 858 undefined on input line 48 429. LaTeX Warning: Hyper reference `IntraMap' on page 858 undefined on input line 4 8429. LaTeX Warning: Hyper reference `astMathMap' on page 858 undefined on input line 48429. LaTeX Warning: Hyper reference `Seed' on page 858 undefined on input line 48429 . LaTeX Warning: Hyper reference `SimpFI' on page 858 undefined on input line 484 29. LaTeX Warning: Hyper reference `SimpIF' on page 858 undefined on input line 484 29. [858] LaTeX Warning: Hyper reference `Mapping' on page 859 undefined on input line 48 463. LaTeX Warning: Hyper reference `astMatrixMap' on page 859 undefined on input li ne 48463. [859] LaTeX Warning: Hyper reference `Region' on page 860 undefined on input line 485 84. LaTeX Warning: Hyper reference `Adaptive' on page 860 undefined on input line 4 8584. LaTeX Warning: Hyper reference `astMoc' on page 860 undefined on input line 485 84. LaTeX Warning: Hyper reference `astGetMocData' on page 860 undefined on input l ine 48584. LaTeX Warning: Hyper reference `astGetMocHeader' on page 860 undefined on input line 48584. LaTeX Warning: Hyper reference `astAddMocData' on page 860 undefined on input l ine 48584. LaTeX Warning: Hyper reference `MaxOrder' on page 860 undefined on input line 4 8584. LaTeX Warning: Hyper reference `MaxRes' on page 860 undefined on input line 485 84. LaTeX Warning: Hyper reference `MinOrder' on page 860 undefined on input line 4 8584. LaTeX Warning: Hyper reference `MinRes' on page 860 undefined on input line 485 84. LaTeX Warning: Hyper reference `MocArea' on page 860 undefined on input line 48 584. LaTeX Warning: Hyper reference `MocLength' on page 860 undefined on input line 48584. LaTeX Warning: Hyper reference `MocType' on page 860 undefined on input line 48 584. LaTeX Warning: Hyper reference `astAddCell' on page 860 undefined on input line 48584. LaTeX Warning: Hyper reference `astAddMocData' on page 860 undefined on input l ine 48584. [860] LaTeX Warning: Hyper reference `astAddMocString' on page 861 undefined on input line 48584. LaTeX Warning: Hyper reference `astAddPixelMask$<$X$>$' on page 861 undefined o n input line 48584. LaTeX Warning: Hyper reference `astAddRegion' on page 861 undefined on input li ne 48584. LaTeX Warning: Hyper reference `astGetCell' on page 861 undefined on input line 48584. LaTeX Warning: Hyper reference `astGetMocData' on page 861 undefined on input l ine 48584. LaTeX Warning: Hyper reference `astGetMocHeader' on page 861 undefined on input line 48584. LaTeX Warning: Hyper reference `astGetMocString' on page 861 undefined on input line 48584. LaTeX Warning: Hyper reference `astTestCell' on page 861 undefined on input lin e 48584. [861] LaTeX Warning: Hyper reference `Channel' on page 862 undefined on input line 48 642. LaTeX Warning: Hyper reference `Moc' on page 862 undefined on input line 48642. LaTeX Warning: Hyper reference `astWrite' on page 862 undefined on input line 4 8642. LaTeX Warning: Hyper reference `SinkFile' on page 862 undefined on input line 4 8642. LaTeX Warning: Hyper reference `SourceFile' on page 862 undefined on input line 48642. LaTeX Warning: Hyper reference `astMocChan' on page 862 undefined on input line 48642. LaTeX Warning: Hyper reference `MocFormat' on page 862 undefined on input line 48642. LaTeX Warning: Hyper reference `MocLineLen' on page 862 undefined on input line 48642. [862] LaTeX Warning: Hyper reference `Mapping' on page 863 undefined on input line 48 686. LaTeX Warning: Hyper reference `astNorm' on page 863 undefined on input line 48 686. LaTeX Warning: Hyper reference `Frame' on page 863 undefined on input line 4868 6. LaTeX Warning: Hyper reference `astSimplify' on page 863 undefined on input lin e 48686. LaTeX Warning: Hyper reference `UnitMap' on page 863 undefined on input line 48 686. LaTeX Warning: Hyper reference `CmpMap' on page 863 undefined on input line 486 86. LaTeX Warning: Hyper reference `astNormMap' on page 863 undefined on input line 48686. [863] LaTeX Warning: Hyper reference `Region' on page 864 undefined on input line 487 19. LaTeX Warning: Hyper reference `Frame' on page 864 undefined on input line 4871 9. LaTeX Warning: Hyper reference `Negated' on page 864 undefined on input line 48 719. LaTeX Warning: Hyper reference `astNullRegion' on page 864 undefined on input l ine 48719. [864] LaTeX Warning: Hyper reference `Class' on page 865 undefined on input line 4886 2. LaTeX Warning: Hyper reference `ID' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `Ident' on page 865 undefined on input line 4886 2. LaTeX Warning: Hyper reference `Nobject' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `ObjSize' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `RefCount' on page 865 undefined on input line 4 8862. LaTeX Warning: Hyper reference `UseDefs' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `astAnnul' on page 865 undefined on input line 4 8862. LaTeX Warning: Hyper reference `astBegin' on page 865 undefined on input line 4 8862. LaTeX Warning: Hyper reference `astClear' on page 865 undefined on input line 4 8862. LaTeX Warning: Hyper reference `astClone' on page 865 undefined on input line 4 8862. LaTeX Warning: Hyper reference `astCopy' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `astCreatedAt' on page 865 undefined on input li ne 48862. LaTeX Warning: Hyper reference `astDelete' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astEnd' on page 865 undefined on input line 488 62. LaTeX Warning: Hyper reference `astEscapes' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astExempt' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astExport' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astGet$<$X$>$' on page 865 undefined on input l ine 48862. LaTeX Warning: Hyper reference `astHasAttribute' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astImport' on page 865 undefined on input line 48862. LaTeX Warning: Hyper reference `astIsA$<$Class$>$' on page 865 undefined on inp ut line 48862. LaTeX Warning: Hyper reference `astLock' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `astToString' on page 865 undefined on input lin e 48862. LaTeX Warning: Hyper reference `astSame' on page 865 undefined on input line 48 862. LaTeX Warning: Hyper reference `astSet' on page 865 undefined on input line 488 62. LaTeX Warning: Hyper reference `astSet$<$X$>$' on page 865 undefined on input l ine 48862. [865] LaTeX Warning: Hyper reference `astShow' on page 866 undefined on input line 48 862. LaTeX Warning: Hyper reference `astTest' on page 866 undefined on input line 48 862. LaTeX Warning: Hyper reference `astThread' on page 866 undefined on input line 48862. LaTeX Warning: Hyper reference `astTune' on page 866 undefined on input line 48 862. LaTeX Warning: Hyper reference `astTuneC' on page 866 undefined on input line 4 8862. LaTeX Warning: Hyper reference `astUnlock' on page 866 undefined on input line 48862. LaTeX Warning: Hyper reference `astFromString' on page 866 undefined on input l ine 48862. LaTeX Warning: Hyper reference `astVersion' on page 866 undefined on input line 48862. [866] LaTeX Warning: Hyper reference `Mapping' on page 867 undefined on input line 48 919. LaTeX Warning: Hyper reference `Disco' on page 867 undefined on input line 4891 9. LaTeX Warning: Hyper reference `astPcdMap' on page 867 undefined on input line 48919. LaTeX Warning: Hyper reference `Disco' on page 867 undefined on input line 4891 9. LaTeX Warning: Hyper reference `PcdCen(axis)' on page 867 undefined on input li ne 48919. [867] LaTeX Warning: Hyper reference `Mapping' on page 868 undefined on input line 48 955. LaTeX Warning: Hyper reference `astPermMap' on page 868 undefined on input line 48955. [868] LaTeX Warning: Hyper reference `FrameSet' on page 869 undefined on input line 4 9267. LaTeX Warning: Hyper reference `Frame' on page 869 undefined on input line 4926 7. LaTeX Warning: Hyper reference `Mapping' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `astCurve' on page 869 undefined on input line 4 9267. LaTeX Warning: Hyper reference `astGenCurve' on page 869 undefined on input lin e 49267. LaTeX Warning: Hyper reference `astPolyCurve' on page 869 undefined on input li ne 49267. LaTeX Warning: Hyper reference `astMark' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `astText' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `astGridLine' on page 869 undefined on input lin e 49267. LaTeX Warning: Hyper reference `astGrid' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `Current' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `astClip' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `astPlot' on page 869 undefined on input line 49 267. LaTeX Warning: Hyper reference `Border' on page 869 undefined on input line 492 67. LaTeX Warning: Hyper reference `Clip' on page 869 undefined on input line 49267 . LaTeX Warning: Hyper reference `ClipOp' on page 869 undefined on input line 492 67. LaTeX Warning: Hyper reference `Colour(element)' on page 869 undefined on input line 49267. LaTeX Warning: Hyper reference `DrawAxes(axis)' on page 869 undefined on input line 49267. LaTeX Warning: Hyper reference `DrawTitle' on page 869 undefined on input line 49267. LaTeX Warning: Hyper reference `Escape' on page 869 undefined on input line 492 67. LaTeX Warning: Hyper reference `Edge(axis)' on page 869 undefined on input line 49267. LaTeX Warning: Hyper reference `Font(element)' on page 869 undefined on input l ine 49267. [869] LaTeX Warning: Hyper reference `Gap(axis)' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `Interval' on page 870 undefined on input line 4 9267. LaTeX Warning: Hyper reference `Grf' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `Grid' on page 870 undefined on input line 49267 . LaTeX Warning: Hyper reference `Invisible' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `LabelAt(axis)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `LabelUnits(axis)' on page 870 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `LabelUp(axis)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `Labelling' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `LogGap(axis)' on page 870 undefined on input li ne 49267. LaTeX Warning: Hyper reference `LogPlot(axis)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `LogTicks(axis)' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `MajTickLen(axis)' on page 870 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `MinTickLen(axis)' on page 870 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `MinTick(axis)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `NumLab(axis)' on page 870 undefined on input li ne 49267. LaTeX Warning: Hyper reference `NumLabGap(axis)' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `Size(element)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `Style(element)' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `TextGapType' on page 870 undefined on input lin e 49267. LaTeX Warning: Hyper reference `TitleGap' on page 870 undefined on input line 4 9267. LaTeX Warning: Hyper reference `TextLab(axis)' on page 870 undefined on input l ine 49267. LaTeX Warning: Hyper reference `TextLabGap(axis)' on page 870 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `TickAll' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `TitleGap' on page 870 undefined on input line 4 9267. LaTeX Warning: Hyper reference `Tol' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `Width(element)' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astBBuf' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `astBorder' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astBoundingBox' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astClip' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `astCurve' on page 870 undefined on input line 4 9267. LaTeX Warning: Hyper reference `astEBuf' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `astGenCurve' on page 870 undefined on input lin e 49267. LaTeX Warning: Hyper reference `astGetGrfContext' on page 870 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `astGrfPop' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astGrfPush' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astGrfSet' on page 870 undefined on input line 49267. LaTeX Warning: Hyper reference `astGrid' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `astGridLine' on page 870 undefined on input lin e 49267. LaTeX Warning: Hyper reference `astMark' on page 870 undefined on input line 49 267. LaTeX Warning: Hyper reference `astPolyCurve' on page 870 undefined on input li ne 49267. [870] LaTeX Warning: Hyper reference `astRegionOutline' on page 871 undefined on inpu t line 49267. LaTeX Warning: Hyper reference `Region' on page 871 undefined on input line 492 67. LaTeX Warning: Hyper reference `astText' on page 871 undefined on input line 49 267. LaTeX Warning: Hyper reference `Axis' on page 871 undefined on input line 49267 . LaTeX Warning: Hyper reference `Title' on page 871 undefined on input line 4926 7. [871] LaTeX Warning: Hyper reference `Plot' on page 872 undefined on input line 49388 . LaTeX Warning: Hyper reference `Frame' on page 872 undefined on input line 4938 8. LaTeX Warning: Hyper reference `ast_link' on page 872 undefined on input line 4 9388. LaTeX Warning: Hyper reference `Current' on page 872 undefined on input line 49 388. LaTeX Warning: Hyper reference `FrameSet' on page 872 undefined on input line 4 9388. LaTeX Warning: Hyper reference `Mapping' on page 872 undefined on input line 49 388. LaTeX Warning: Hyper reference `astClip' on page 872 undefined on input line 49 388. LaTeX Warning: Hyper reference `astGrfSet' on page 872 undefined on input line 49388. LaTeX Warning: Hyper reference `astGrfPop' on page 872 undefined on input line 49388. LaTeX Warning: Hyper reference `astGrfPush' on page 872 undefined on input line 49388. LaTeX Warning: Hyper reference `astGetGrfContext' on page 872 undefined on inpu t line 49388. LaTeX Warning: Hyper reference `astPlot3D' on page 872 undefined on input line 49388. [872] LaTeX Warning: Hyper reference `RootCorner' on page 873 undefined on input line 49388. LaTeX Warning: Hyper reference `DrawTitle' on page 873 undefined on input line 49388. LaTeX Warning: Hyper reference `TitleGap' on page 873 undefined on input line 4 9388. LaTeX Warning: Hyper reference `Grid' on page 873 undefined on input line 49388 . LaTeX Warning: Hyper reference `astBoundingBox' on page 873 undefined on input line 49388. LaTeX Warning: Hyper reference `astCurve' on page 873 undefined on input line 4 9388. LaTeX Warning: Hyper reference `astGenCurve' on page 873 undefined on input lin e 49388. LaTeX Warning: Hyper reference `astGridLine' on page 873 undefined on input lin e 49388. LaTeX Warning: Hyper reference `astPolyCurve' on page 873 undefined on input li ne 49388. [873] LaTeX Warning: Hyper reference `Region' on page 874 undefined on input line 494 24. LaTeX Warning: Hyper reference `Frame' on page 874 undefined on input line 4942 4. LaTeX Warning: Hyper reference `astPointList' on page 874 undefined on input li ne 49424. LaTeX Warning: Hyper reference `ListSize' on page 874 undefined on input line 4 9424. [874] LaTeX Warning: Hyper reference `Mapping' on page 875 undefined on input line 49 481. LaTeX Warning: Hyper reference `IterInverse' on page 875 undefined on input lin e 49481. LaTeX Warning: Hyper reference `astPolyMap' on page 875 undefined on input line 49481. LaTeX Warning: Hyper reference `IterInverse' on page 875 undefined on input lin e 49481. LaTeX Warning: Hyper reference `NiterInverse' on page 875 undefined on input li ne 49481. LaTeX Warning: Hyper reference `TolInverse' on page 875 undefined on input line 49481. LaTeX Warning: Hyper reference `astPolyCoeffs' on page 875 undefined on input l ine 49481. LaTeX Warning: Hyper reference `astPolyTran' on page 875 undefined on input lin e 49481. [875] LaTeX Warning: Hyper reference `Frame' on page 876 undefined on input line 4954 7. LaTeX Warning: Hyper reference `SkyFrame' on page 876 undefined on input line 4 9547. LaTeX Warning: Hyper reference `astPolygon' on page 876 undefined on input line 49547. LaTeX Warning: Hyper reference `Region' on page 876 undefined on input line 495 47. LaTeX Warning: Hyper reference `SimpVertices' on page 876 undefined on input li ne 49547. LaTeX Warning: Hyper reference `astDownsize' on page 876 undefined on input lin e 49547. LaTeX Warning: Hyper reference `astConvex$<$X$>$' on page 876 undefined on inpu t line 49547. LaTeX Warning: Hyper reference `astOutline$<$X$>$' on page 876 undefined on inp ut line 49547. [876] LaTeX Warning: Hyper reference `Region' on page 877 undefined on input line 495 87. LaTeX Warning: Hyper reference `Circle' on page 877 undefined on input line 495 87. LaTeX Warning: Hyper reference `Interval' on page 877 undefined on input line 4 9587. LaTeX Warning: Hyper reference `astPrism' on page 877 undefined on input line 4 9587. [877] LaTeX Warning: Hyper reference `Mapping' on page 878 undefined on input line 49 630. LaTeX Warning: Hyper reference `astRateMap' on page 878 undefined on input line 49630. [878] LaTeX Warning: Hyper reference `Circle' on page 879 undefined on input line 497 98. LaTeX Warning: Hyper reference `Box' on page 879 undefined on input line 49798. LaTeX Warning: Hyper reference `Frame' on page 879 undefined on input line 4979 8. LaTeX Warning: Hyper reference `astFormat' on page 879 undefined on input line 49798. LaTeX Warning: Hyper reference `Mapping' on page 879 undefined on input line 49 798. LaTeX Warning: Hyper reference `astPointInRegion' on page 879 undefined on inpu t line 49798. LaTeX Warning: Hyper reference `UnitMap' on page 879 undefined on input line 49 798. LaTeX Warning: Hyper reference `astRemoveRegions' on page 879 undefined on inpu t line 49798. LaTeX Warning: Hyper reference `FrameSet' on page 879 undefined on input line 4 9798. LaTeX Warning: Hyper reference `SkyFrame' on page 879 undefined on input line 4 9798. LaTeX Warning: Hyper reference `System' on page 879 undefined on input line 497 98. LaTeX Warning: Hyper reference `astSimplify' on page 879 undefined on input lin e 49798. [879] LaTeX Warning: Hyper reference `Adaptive' on page 880 undefined on input line 4 9798. LaTeX Warning: Hyper reference `Negated' on page 880 undefined on input line 49 798. LaTeX Warning: Hyper reference `Closed' on page 880 undefined on input line 497 98. LaTeX Warning: Hyper reference `MeshSize' on page 880 undefined on input line 4 9798. LaTeX Warning: Hyper reference `FillFactor' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `Bounded' on page 880 undefined on input line 49 798. LaTeX Warning: Hyper reference `Equinox' on page 880 undefined on input line 49 798. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 880 undefined on in put line 49798. LaTeX Warning: Hyper reference `astGetRegionFrame' on page 880 undefined on inp ut line 49798. LaTeX Warning: Hyper reference `astGetRegionFrameSet' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 880 undefined on inpu t line 49798. LaTeX Warning: Hyper reference `astGetRegionPoints' on page 880 undefined on in put line 49798. LaTeX Warning: Hyper reference `astGetUnc' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 880 undefined on inpu t line 49798. LaTeX Warning: Hyper reference `astMapRegion' on page 880 undefined on input li ne 49798. LaTeX Warning: Hyper reference `astNegate' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astOverlap' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astPointInRegion' on page 880 undefined on inpu t line 49798. LaTeX Warning: Hyper reference `astMask$<$X$>$' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astSetUnc' on page 880 undefined on input line 49798. LaTeX Warning: Hyper reference `astShowMesh' on page 880 undefined on input lin e 49798. [880] LaTeX Warning: Hyper reference `Mapping' on page 881 undefined on input line 49 852. LaTeX Warning: Hyper reference `Region' on page 881 undefined on input line 498 52. LaTeX Warning: Hyper reference `Frame' on page 881 undefined on input line 4985 2. LaTeX Warning: Hyper reference `Nin' on page 881 undefined on input line 49852. LaTeX Warning: Hyper reference `UnitMap' on page 881 undefined on input line 49 852. LaTeX Warning: Hyper reference `astSimplify' on page 881 undefined on input lin e 49852. LaTeX Warning: Hyper reference `astSelectorMap' on page 881 undefined on input line 49852. [881] LaTeX Warning: Hyper reference `Mapping' on page 882 undefined on input line 49 882. LaTeX Warning: Hyper reference `astShiftMap' on page 882 undefined on input lin e 49882. [882] LaTeX Warning: Hyper reference `SkyFrame' on page 883 undefined on input line 4 9902. LaTeX Warning: Hyper reference `astWrite' on page 883 undefined on input line 4 9902. LaTeX Warning: Hyper reference `Axis' on page 883 undefined on input line 49902 . [883] LaTeX Warning: Hyper reference `Frame' on page 884 undefined on input line 5000 5. LaTeX Warning: Hyper reference `System' on page 884 undefined on input line 500 05. LaTeX Warning: Hyper reference `Equinox' on page 884 undefined on input line 50 005. LaTeX Warning: Hyper reference `Epoch' on page 884 undefined on input line 5000 5. LaTeX Warning: Hyper reference `SkyRefIs' on page 884 undefined on input line 5 0005. LaTeX Warning: Hyper reference `AlignOffset' on page 884 undefined on input lin e 50005. LaTeX Warning: Hyper reference `astFormat' on page 884 undefined on input line 50005. LaTeX Warning: Hyper reference `astSkyFrame' on page 884 undefined on input lin e 50005. LaTeX Warning: Hyper reference `AlignOffset' on page 884 undefined on input lin e 50005. LaTeX Warning: Hyper reference `AsTime(axis)' on page 884 undefined on input li ne 50005. LaTeX Warning: Hyper reference `Equinox' on page 884 undefined on input line 50 005. LaTeX Warning: Hyper reference `LatAxis' on page 884 undefined on input line 50 005. LaTeX Warning: Hyper reference `LonAxis' on page 884 undefined on input line 50 005. LaTeX Warning: Hyper reference `NegLon' on page 884 undefined on input line 500 05. LaTeX Warning: Hyper reference `Projection' on page 884 undefined on input line 50005. LaTeX Warning: Hyper reference `SkyRefIs' on page 884 undefined on input line 5 0005. LaTeX Warning: Hyper reference `SkyTol' on page 884 undefined on input line 500 05. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 884 undefined on input line 50005. LaTeX Warning: Hyper reference `Mapping' on page 884 undefined on input line 50 005. [884] LaTeX Warning: Hyper reference `Mapping' on page 885 undefined on input line 50 054. LaTeX Warning: Hyper reference `astSlaAdd' on page 885 undefined on input line 50054. LaTeX Warning: Hyper reference `astSlaMap' on page 885 undefined on input line 50054. LaTeX Warning: Hyper reference `astSlaAdd' on page 885 undefined on input line 50054. [885] LaTeX Warning: Hyper reference `SpecFrame' on page 886 undefined on input line 50092. LaTeX Warning: Hyper reference `FluxFrame' on page 886 undefined on input line 50092. LaTeX Warning: Hyper reference `Frame' on page 886 undefined on input line 5009 2. LaTeX Warning: Hyper reference `Plot' on page 886 undefined on input line 50092 . LaTeX Warning: Hyper reference `astSpecFluxFrame' on page 886 undefined on inpu t line 50092. LaTeX Warning: Hyper reference `CmpFrame' on page 886 undefined on input line 5 0092. LaTeX Warning: Hyper reference `StdOfRest' on page 886 undefined on input line 50092. [886] LaTeX Warning: Hyper reference `Frame' on page 887 undefined on input line 5018 0. LaTeX Warning: Hyper reference `System' on page 887 undefined on input line 501 80. LaTeX Warning: Hyper reference `SpecOrigin' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `astSpecFrame' on page 887 undefined on input li ne 50180. LaTeX Warning: Hyper reference `AlignSpecOffset' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `AlignStdOfRest' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `RefDec' on page 887 undefined on input line 501 80. LaTeX Warning: Hyper reference `RefRA' on page 887 undefined on input line 5018 0. LaTeX Warning: Hyper reference `RestFreq' on page 887 undefined on input line 5 0180. LaTeX Warning: Hyper reference `SourceSys' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `SourceVel' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `SourceVRF' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `SpecOrigin' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `StdOfRest' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `Unit(axis)' on page 887 undefined on input line 50180. LaTeX Warning: Hyper reference `Label(axis)' on page 887 undefined on input lin e 50180. LaTeX Warning: Hyper reference `astSetRefPos' on page 887 undefined on input li ne 50180. LaTeX Warning: Hyper reference `astGetRefPos' on page 887 undefined on input li ne 50180. [887] LaTeX Warning: Hyper reference `Mapping' on page 888 undefined on input line 50 241. LaTeX Warning: Hyper reference `astSpecAdd' on page 888 undefined on input line 50241. LaTeX Warning: Hyper reference `astSpecMap' on page 888 undefined on input line 50241. LaTeX Warning: Hyper reference `astSpecAdd' on page 888 undefined on input line 50241. [888] LaTeX Warning: Hyper reference `Mapping' on page 889 undefined on input line 50 286. LaTeX Warning: Hyper reference `astSphMap' on page 889 undefined on input line 50286. LaTeX Warning: Hyper reference `UnitRadius' on page 889 undefined on input line 50286. LaTeX Warning: Hyper reference `PolarLong' on page 889 undefined on input line 50286. [889] LaTeX Warning: Hyper reference `StcCatalogEntryLocation' on page 890 undefined on input line 50341. LaTeX Warning: Hyper reference `StcResourceProfile' on page 890 undefined on in put line 50341. LaTeX Warning: Hyper reference `StcSearchLocation' on page 890 undefined on inp ut line 50341. LaTeX Warning: Hyper reference `StcObsDataLocation' on page 890 undefined on in put line 50341. LaTeX Warning: Hyper reference `Region' on page 890 undefined on input line 503 41. LaTeX Warning: Hyper reference `RegionClass' on page 890 undefined on input lin e 50341. LaTeX Warning: Hyper reference `astGetStcRegion' on page 890 undefined on input line 50341. LaTeX Warning: Hyper reference `astGetStcCoord' on page 890 undefined on input line 50341. LaTeX Warning: Hyper reference `astGetStcNCoord' on page 890 undefined on input line 50341. [890] LaTeX Warning: Hyper reference `Stc' on page 891 undefined on input line 50373. LaTeX Warning: Hyper reference `astStcCatalogEntryLocation' on page 891 undefin ed on input line 50373. [891] LaTeX Warning: Hyper reference `Stc' on page 892 undefined on input line 50424. LaTeX Warning: Hyper reference `Frame' on page 892 undefined on input line 5042 4. LaTeX Warning: Hyper reference `ObsLon' on page 892 undefined on input line 504 24. LaTeX Warning: Hyper reference `ObsLat' on page 892 undefined on input line 504 24. LaTeX Warning: Hyper reference `astStcObsDataLocation' on page 892 undefined on input line 50424. [892] LaTeX Warning: Hyper reference `Stc' on page 893 undefined on input line 50456. LaTeX Warning: Hyper reference `astStcResourceProfile' on page 893 undefined on input line 50456. [893] LaTeX Warning: Hyper reference `Stc' on page 894 undefined on input line 50488. LaTeX Warning: Hyper reference `astStcSearchLocation' on page 894 undefined on input line 50488. [894] LaTeX Warning: Hyper reference `Channel' on page 895 undefined on input line 50 650. LaTeX Warning: Hyper reference `Object' on page 895 undefined on input line 506 50. LaTeX Warning: Hyper reference `astWrite' on page 895 undefined on input line 5 0650. LaTeX Warning: Hyper reference `astRead' on page 895 undefined on input line 50 650. LaTeX Warning: Hyper reference `PointList' on page 895 undefined on input line 50650. LaTeX Warning: Hyper reference `Region' on page 895 undefined on input line 506 50. LaTeX Warning: Hyper reference `KeyMap' on page 895 undefined on input line 506 50. LaTeX Warning: Hyper reference `StcsArea' on page 895 undefined on input line 5 0650. LaTeX Warning: Hyper reference `StcsCoords' on page 895 undefined on input line 50650. LaTeX Warning: Hyper reference `StcsProps' on page 895 undefined on input line 50650. LaTeX Warning: Hyper reference `XmlChan' on page 895 undefined on input line 50 650. LaTeX Warning: Hyper reference `SinkFile' on page 895 undefined on input line 5 0650. LaTeX Warning: Hyper reference `SourceFile' on page 895 undefined on input line 50650. LaTeX Warning: Hyper reference `TimeFrame' on page 895 undefined on input line 50650. LaTeX Warning: Hyper reference `SkyFrame' on page 895 undefined on input line 5 0650. [895] Overfull \hbox (7.12534pt too wide) in paragraph at lines 50650--50650 \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 896 undefined on input lin e 50650. LaTeX Warning: Hyper reference `StcsArea' on page 896 undefined on input line 5 0650. LaTeX Warning: Hyper reference `StcsCoords' on page 896 undefined on input line 50650. LaTeX Warning: Hyper reference `StcsLength' on page 896 undefined on input line 50650. LaTeX Warning: Hyper reference `StcsProps' on page 896 undefined on input line 50650. [896] LaTeX Warning: Hyper reference `Mapping' on page 897 undefined on input line 50 739. LaTeX Warning: Hyper reference `Nin' on page 897 undefined on input line 50739. LaTeX Warning: Hyper reference `Nout' on page 897 undefined on input line 50739 . LaTeX Warning: Hyper reference `SelectorMap' on page 897 undefined on input lin e 50739. LaTeX Warning: Hyper reference `UnitMap' on page 897 undefined on input line 50 739. LaTeX Warning: Hyper reference `astSimplify' on page 897 undefined on input lin e 50739. LaTeX Warning: Hyper reference `astSwitchMap' on page 897 undefined on input li ne 50739. [897] [898] LaTeX Warning: Hyper reference `KeyMap' on page 899 undefined on input line 508 62. LaTeX Warning: Hyper reference `astAddColumn' on page 899 undefined on input li ne 50862. LaTeX Warning: Hyper reference `astAddParameter' on page 899 undefined on input line 50862. LaTeX Warning: Hyper reference `astTable' on page 899 undefined on input line 5 0862. LaTeX Warning: Hyper reference `ColumnLenC(column)' on page 899 undefined on in put line 50862. LaTeX Warning: Hyper reference `ColumnLength(column)' on page 899 undefined on input line 50862. LaTeX Warning: Hyper reference `ColumnNdim(column)' on page 899 undefined on in put line 50862. LaTeX Warning: Hyper reference `ColumnType(column)' on page 899 undefined on in put line 50862. LaTeX Warning: Hyper reference `Ncolumn' on page 899 undefined on input line 50 862. LaTeX Warning: Hyper reference `Nrow' on page 899 undefined on input line 50862 . LaTeX Warning: Hyper reference `Nparameter' on page 899 undefined on input line 50862. LaTeX Warning: Hyper reference `astAddColumn' on page 899 undefined on input li ne 50862. LaTeX Warning: Hyper reference `astAddParameter' on page 899 undefined on input line 50862. LaTeX Warning: Hyper reference `astColumnName' on page 899 undefined on input l ine 50862. LaTeX Warning: Hyper reference `astColumnShape' on page 899 undefined on input line 50862. LaTeX Warning: Hyper reference `astHasColumn' on page 899 undefined on input li ne 50862. [899] LaTeX Warning: Hyper reference `astHasParameter' on page 900 undefined on input line 50862. LaTeX Warning: Hyper reference `astParameterName' on page 900 undefined on inpu t line 50862. LaTeX Warning: Hyper reference `astPurgeRows' on page 900 undefined on input li ne 50862. LaTeX Warning: Hyper reference `astRemoveColumn' on page 900 undefined on input line 50862. LaTeX Warning: Hyper reference `astRemoveParameter' on page 900 undefined on in put line 50862. LaTeX Warning: Hyper reference `astRemoveRow' on page 900 undefined on input li ne 50862. [900] LaTeX Warning: Hyper reference `Frame' on page 901 undefined on input line 5094 6. LaTeX Warning: Hyper reference `System' on page 901 undefined on input line 509 46. LaTeX Warning: Hyper reference `TimeOrigin' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `TimeScale' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `astTimeFrame' on page 901 undefined on input li ne 50946. LaTeX Warning: Hyper reference `AlignTimeScale' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `LTOffset' on page 901 undefined on input line 5 0946. LaTeX Warning: Hyper reference `TimeOrigin' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `TimeScale' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `Unit(axis)' on page 901 undefined on input line 50946. LaTeX Warning: Hyper reference `Label(axis)' on page 901 undefined on input lin e 50946. LaTeX Warning: Hyper reference `astCurrentTime' on page 901 undefined on input line 50946. [901] LaTeX Warning: Hyper reference `Mapping' on page 902 undefined on input line 50 993. LaTeX Warning: Hyper reference `astTimeAdd' on page 902 undefined on input line 50993. LaTeX Warning: Hyper reference `astTimeMap' on page 902 undefined on input line 50993. LaTeX Warning: Hyper reference `astTimeAdd' on page 902 undefined on input line 50993. [902] LaTeX Warning: Hyper reference `Mapping' on page 903 undefined on input line 51 032. LaTeX Warning: Hyper reference `astTranMap' on page 903 undefined on input line 51032. [903] LaTeX Warning: Hyper reference `Mapping' on page 904 undefined on input line 51 066. LaTeX Warning: Hyper reference `Nin' on page 904 undefined on input line 51066. LaTeX Warning: Hyper reference `Nout' on page 904 undefined on input line 51066 . LaTeX Warning: Hyper reference `astUnitMap' on page 904 undefined on input line 51066. [904] LaTeX Warning: Hyper reference `Nin' on page 905 undefined on input line 51123. LaTeX Warning: Hyper reference `astUnitNormMap' on page 905 undefined on input line 51123. LaTeX Warning: Hyper reference `Mapping' on page 905 undefined on input line 51 123. [905] LaTeX Warning: Hyper reference `Mapping' on page 906 undefined on input line 51 212. LaTeX Warning: Hyper reference `WcsType' on page 906 undefined on input line 51 212. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 906 undefined on input line 51212. LaTeX Warning: Hyper reference `PVi_m' on page 906 undefined on input line 5121 2. LaTeX Warning: Hyper reference `astWcsMap' on page 906 undefined on input line 51212. LaTeX Warning: Hyper reference `NatLat' on page 906 undefined on input line 512 12. LaTeX Warning: Hyper reference `NatLon' on page 906 undefined on input line 512 12. LaTeX Warning: Hyper reference `PVi_m' on page 906 undefined on input line 5121 2. LaTeX Warning: Hyper reference `WcsAxis(lonlat)' on page 906 undefined on input line 51212. LaTeX Warning: Hyper reference `WcsType' on page 906 undefined on input line 51 212. [906] [907] LaTeX Warning: Hyper reference `Mapping' on page 908 undefined on input line 51 248. LaTeX Warning: Hyper reference `astWinMap' on page 908 undefined on input line 51248. [908] LaTeX Warning: Hyper reference `Channel' on page 909 undefined on input line 51 305. LaTeX Warning: Hyper reference `Object' on page 909 undefined on input line 513 05. LaTeX Warning: Hyper reference `astWrite' on page 909 undefined on input line 5 1305. LaTeX Warning: Hyper reference `SinkFile' on page 909 undefined on input line 5 1305. LaTeX Warning: Hyper reference `SourceFile' on page 909 undefined on input line 51305. LaTeX Warning: Hyper reference `astXmlChan' on page 909 undefined on input line 51305. LaTeX Warning: Hyper reference `XmlFormat' on page 909 undefined on input line 51305. LaTeX Warning: Hyper reference `System' on page 909 undefined on input line 513 05. LaTeX Warning: Hyper reference `XmlLength' on page 909 undefined on input line 51305. LaTeX Warning: Hyper reference `XmlPrefix' on page 909 undefined on input line 51305. [909] LaTeX Warning: Hyper reference `Channel' on page 910 undefined on input line 51 379. LaTeX Warning: Hyper reference `Object' on page 910 undefined on input line 513 79. LaTeX Warning: Hyper reference `astWrite' on page 910 undefined on input line 5 1379. LaTeX Warning: Hyper reference `YamlEncoding' on page 910 undefined on input li ne 51379. LaTeX Warning: Hyper reference `SinkFile' on page 910 undefined on input line 5 1379. LaTeX Warning: Hyper reference `SourceFile' on page 910 undefined on input line 51379. LaTeX Warning: Hyper reference `astYamlChan' on page 910 undefined on input lin e 51379. LaTeX Warning: Hyper reference `VerboseRead' on page 910 undefined on input lin e 51379. LaTeX Warning: Hyper reference `PreserveName' on page 910 undefined on input li ne 51379. LaTeX Warning: Hyper reference `Ident' on page 910 undefined on input line 5137 9. LaTeX Warning: Hyper reference `YamlEncoding' on page 910 undefined on input li ne 51379. [910] LaTeX Warning: Hyper reference `Mapping' on page 911 undefined on input line 51 418. LaTeX Warning: Hyper reference `astZoomMap' on page 911 undefined on input line 51418. LaTeX Warning: Hyper reference `Zoom' on page 911 undefined on input line 51418 . [911] [912] [913] Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 LaTeX Warning: Hyper reference `System' on page 914 undefined on input line 515 97. [914] [915] LaTeX Warning: Hyper reference `ast_link' on page 916 undefined on input line 5 1762. Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 [916] LaTeX Warning: Hyper reference `System' on page 917 undefined on input line 517 62. [917] [918] LaTeX Warning: Hyper reference `astMalloc' on page 919 undefined on input line 51769. LaTeX Warning: Hyper reference `astFree' on page 919 undefined on input line 51 770. LaTeX Warning: Hyper reference `astRealloc' on page 919 undefined on input line 51770. LaTeX Warning: Hyper reference `astStore' on page 919 undefined on input line 5 1782. LaTeX Warning: Hyper reference `astGrow' on page 919 undefined on input line 51 785. LaTeX Warning: Hyper reference `astAppendString' on page 919 undefined on input line 51786. [919] Overfull \hbox (5.62103pt too wide) in paragraph at lines 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 [] \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 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 []\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 51884--51884 \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 920 undefined on input line 51 884. Overfull \hbox (28.50703pt too wide) in paragraph at lines 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 [][]\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 51884--51884 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [920] LaTeX Warning: Hyper reference `astAppendString' on page 921 undefined on input line 51960. Overfull \hbox (5.62103pt too wide) in paragraph at lines 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 [] \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 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 []\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 51960--51960 \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 51960--51960 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (16.11847pt too wide) in paragraph at lines 51960--51960 [] \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 51960--51960 \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 51960--51960 LaTeX Warning: Hyper reference `astFree' on page 921 undefined on input line 51 960. Overfull \hbox (28.50703pt too wide) in paragraph at lines 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 [][]\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 51960--51960 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [921] Overfull \hbox (21.10757pt too wide) in paragraph at lines 52081--52081 []\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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 922 undefined on input line 52 081. Overfull \hbox (21.10475pt too wide) in paragraph at lines 52081--52081 \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 52081--52081 \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 52081--52081 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.36719pt too wide) in paragraph at lines 52081--52081 [] \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [922] Overfull \hbox (7.51216pt too wide) in paragraph at lines 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 [][]\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 52081--52081 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [923] LaTeX Warning: Hyper reference `astMalloc' on page 924 undefined on input line 52129. Overfull \hbox (2.26344pt too wide) in paragraph at lines 52129--52129 \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 52129--52129 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [924] Overfull \hbox (21.10475pt too wide) in paragraph at lines 52165--52165 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [925] LaTeX Warning: Hyper reference `astStringCase' on page 926 undefined on input l ine 52209. Overfull \hbox (42.36206pt too wide) in paragraph at lines 52209--52209 [] \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [926] [927] Overfull \hbox (10.13652pt too wide) in paragraph at lines 52260--52260 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [928] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52301--52301 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [929] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52347--52347 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [930] LaTeX Warning: Hyper reference `astChrClean' on page 931 undefined on input lin e 52368. [931] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52412--52412 \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 52412--52412 \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 52412--52412 \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 52412--52412 [][]\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 52412--52412 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [932] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52466--52466 \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 52466--52466 \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 52466--52466 [][]\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 52466--52466 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [933] Overfull \hbox (35.49646pt too wide) in paragraph at lines 52540--52540 []\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 934 undefined on input line 52540. Overfull \hbox (23.72911pt too wide) in paragraph at lines 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 934 undefined on input line 52 540. Overfull \hbox (7.72334pt too wide) in paragraph at lines 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 [][]\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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 [][]\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 52540--52540 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [934] Overfull \hbox (13.86804pt too wide) in paragraph at lines 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 935 undefined on input line 52 675. Overfull \hbox (10.13652pt too wide) in paragraph at lines 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 [][]\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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [935] Overfull \hbox (13.02332pt too wide) in paragraph at lines 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 []\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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [936] [937] Overfull \hbox (1.84724pt too wide) in paragraph at lines 52751--52751 []\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 52751--52751 \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 52751--52751 \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 52751--52751 \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 52751--52751 [] \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 52751--52751 [] \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 52751--52751 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [938] Overfull \hbox (10.86975pt too wide) in paragraph at lines 52782--52782 [] \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 52782--52782 \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 52782--52782 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [939] LaTeX Warning: Hyper reference `astGrow' on page 940 undefined on input line 52 820. Overfull \hbox (10.86975pt too wide) in paragraph at lines 52820--52820 [] \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 52820--52820 \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 52820--52820 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [940] Overfull \hbox (12.44437pt too wide) in paragraph at lines 52883--52883 [] \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 52883--52883 \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 52883--52883 [][]\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 52883--52883 \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 52883--52883 \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 52883--52883 [][]\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 52883--52883 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [941] Overfull \hbox (7.7746pt too wide) in paragraph at lines 52924--52924 \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 52924--52924 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [942] Overfull \hbox (2.26344pt too wide) in paragraph at lines 52965--52965 \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 52965--52965 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [943] LaTeX Warning: Hyper reference `astTune' on page 944 undefined on input line 53 001. Overfull \hbox (12.18193pt too wide) in paragraph at lines 53001--53001 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see astTu ne in objectc.c). [944] Overfull \hbox (42.36206pt too wide) in paragraph at lines 53058--53058 [] \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 53058--53058 \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 53058--53058 \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 53058--53058 \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 53058--53058 [][]\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 53058--53058 \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 53058--53058 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [945] [946] Overfull \hbox (0.37231pt too wide) in paragraph at lines 53115--53115 [] \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 53115--53115 \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 53115--53115 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [947] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53179--53179 [] \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 948 undefined on input line 53179. Overfull \hbox (26.6159pt too wide) in paragraph at lines 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 [][]\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 53179--53179 \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 53179--53179 \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 53179--53179 [][]\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 53179--53179 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [948] LaTeX Warning: Hyper reference `astFree' on page 949 undefined on input line 53 231. Overfull \hbox (4.1005pt too wide) in paragraph at lines 53231--53231 \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 53231--53231 \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 53231--53231 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [949] LaTeX Warning: Hyper reference `astFree' on page 950 undefined on input line 53 303. Overfull \hbox (21.10475pt too wide) in paragraph at lines 53303--53303 \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 53303--53303 \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 53303--53303 \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 53303--53303 \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 53303--53303 []\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 53303--53303 \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 53303--53303 [][]\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 53303--53303 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [950] LaTeX Warning: Hyper reference `astChrCase' on page 951 undefined on input line 53348. Overfull \hbox (5.62103pt too wide) in paragraph at lines 53348--53348 \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 951 undefined on input line 53 348. Overfull \hbox (4.1005pt too wide) in paragraph at lines 53348--53348 \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 53348--53348 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [951] LaTeX Warning: Hyper reference `FitsChan' on page 952 undefined on input line 5 3354. LaTeX Warning: Hyper reference `Encoding' on page 952 undefined on input line 5 3358. LaTeX Warning: Hyper reference `FrameSet' on page 952 undefined on input line 5 3360. LaTeX Warning: Hyper reference `astRead' on page 952 undefined on input line 53 362. LaTeX Warning: Hyper reference `astWrite' on page 952 undefined on input line 5 3366. LaTeX Warning: Hyper reference `Frame' on page 952 undefined on input line 5336 7. LaTeX Warning: Hyper reference `MathMap' on page 952 undefined on input line 53 368. LaTeX Warning: Hyper reference `FrameSet' on page 952 undefined on input line 5 3381. LaTeX Warning: Hyper reference `FitsChan' on page 952 undefined on input line 5 3381. LaTeX Warning: Hyper reference `Frame' on page 952 undefined on input line 5338 5. LaTeX Warning: Hyper reference `SkyFrame' on page 952 undefined on input line 5 3386. LaTeX Warning: Hyper reference `SpecFrame' on page 952 undefined on input line 53386. LaTeX Warning: Hyper reference `Table' on page 952 undefined on input line 5338 8. LaTeX Warning: Reference `tab:fitspaper1' on page 952 undefined on input line 5 3388. LaTeX Warning: Hyper reference `Mapping' on page 952 undefined on input line 53 402. LaTeX Warning: Hyper reference `CDMatrix' on page 952 undefined on input line 5 3409. Underfull \hbox (badness 1490) in paragraph at lines 53417--53417 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, LaTeX Warning: Hyper reference `Domain' on page 952 undefined on input line 534 40. Overfull \hbox (7.69725pt too wide) in paragraph at lines 53392--53449 [][] LaTeX Warning: Hyper reference `FrameSet' on page 952 undefined on input line 5 3454. LaTeX Warning: Hyper reference `Frame' on page 952 undefined on input line 5345 5. LaTeX Warning: Hyper reference `FitsChan' on page 952 undefined on input line 5 3455. LaTeX Warning: Hyper reference `Mapping' on page 952 undefined on input line 53 456. LaTeX Warning: Hyper reference `FrameSet' on page 952 undefined on input line 5 3461. LaTeX Warning: Hyper reference `FitsChan' on page 952 undefined on input line 5 3461. LaTeX Warning: Hyper reference `Frame' on page 952 undefined on input line 5346 2. LaTeX Warning: Hyper reference `SkyFrame' on page 952 undefined on input line 5 3476. LaTeX Warning: Hyper reference `SpecFrame' on page 952 undefined on input line 53476. LaTeX Warning: Hyper reference `System' on page 952 undefined on input line 534 77. LaTeX Warning: Hyper reference `Mapping' on page 952 undefined on input line 53 478. [952] [953] LaTeX Warning: Hyper reference `FrameSet' on page 954 undefined on input line 5 3482. LaTeX Warning: Hyper reference `FitsChan' on page 954 undefined on input line 5 3483. LaTeX Warning: Hyper reference `Frame' on page 954 undefined on input line 5349 1. LaTeX Warning: Hyper reference `Mapping' on page 954 undefined on input line 53 502. LaTeX Warning: Hyper reference `SkyFrame' on page 954 undefined on input line 5 3506. LaTeX Warning: Hyper reference `SpecFrame' on page 954 undefined on input line 53506. LaTeX Warning: Hyper reference `FrameSet' on page 954 undefined on input line 5 3511. LaTeX Warning: Hyper reference `FitsChan' on page 954 undefined on input line 5 3512. LaTeX Warning: Hyper reference `Frame' on page 954 undefined on input line 5351 3. LaTeX Warning: Hyper reference `FrameSet' on page 954 undefined on input line 5 3522. LaTeX Warning: Hyper reference `FitsChan' on page 954 undefined on input line 5 3523. LaTeX Warning: Hyper reference `Frame' on page 954 undefined on input line 5352 4. LaTeX Warning: Hyper reference `Mapping' on page 954 undefined on input line 53 526. LaTeX Warning: Hyper reference `Ident' on page 954 undefined on input line 5352 6. [954] LaTeX Warning: Hyper reference `FrameSet' on page 955 undefined on input line 5 3546. LaTeX Warning: Hyper reference `FitsChan' on page 955 undefined on input line 5 3547. LaTeX Warning: Hyper reference `Frame' on page 955 undefined on input line 5354 8. LaTeX Warning: Hyper reference `SkyFrame' on page 955 undefined on input line 5 3549. LaTeX Warning: Hyper reference `Table' on page 955 undefined on input line 5355 1. LaTeX Warning: Reference `tab:fitspaper2' on page 955 undefined on input line 5 3551. LaTeX Warning: Hyper reference `System' on page 955 undefined on input line 535 65. LaTeX Warning: Hyper reference `WcsType' on page 955 undefined on input line 53 565. LaTeX Warning: Hyper reference `WcsMap' on page 955 undefined on input line 535 65. LaTeX Warning: Hyper reference `Mapping' on page 955 undefined on input line 53 571. LaTeX Warning: Hyper reference `PVi_m' on page 955 undefined on input line 5357 6. Underfull \hbox (badness 2103) in paragraph at lines 53586--53586 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the LaTeX Warning: Hyper reference `Equinox' on page 955 undefined on input line 53 590. Underfull \hbox (badness 4291) in paragraph at lines 53594--53595 []|\T1/ppl/m/n/10.95 (+20) Only writ-ten if us-ing FITS-AIPS LaTeX Warning: Hyper reference `Epoch' on page 955 undefined on input line 5360 1. Overfull \hbox (1.56534pt too wide) in paragraph at lines 53555--53606 [][] LaTeX Warning: Hyper reference `FrameSet' on page 955 undefined on input line 5 3611. LaTeX Warning: Hyper reference `Frame' on page 955 undefined on input line 5361 2. LaTeX Warning: Hyper reference `SkyFrame' on page 955 undefined on input line 5 3612. LaTeX Warning: Hyper reference `FitsChan' on page 955 undefined on input line 5 3613. LaTeX Warning: Hyper reference `Mapping' on page 955 undefined on input line 53 617. LaTeX Warning: Hyper reference `WcsMap' on page 955 undefined on input line 536 18. LaTeX Warning: Hyper reference `TabOK' on page 955 undefined on input line 5362 3. LaTeX Warning: Hyper reference `FrameSet' on page 955 undefined on input line 5 3633. LaTeX Warning: Hyper reference `FitsChan' on page 955 undefined on input line 5 3633. LaTeX Warning: Hyper reference `WcsMap' on page 955 undefined on input line 536 38. [955] [956] LaTeX Warning: Hyper reference `Mapping' on page 957 undefined on input line 53 664. LaTeX Warning: Hyper reference `FrameSet' on page 957 undefined on input line 5 3669. LaTeX Warning: Hyper reference `FitsChan' on page 957 undefined on input line 5 3669. LaTeX Warning: Hyper reference `WcsMap' on page 957 undefined on input line 536 73. LaTeX Warning: Hyper reference `PVi_m' on page 957 undefined on input line 5367 6. LaTeX Warning: Hyper reference `FrameSet' on page 957 undefined on input line 5 3689. LaTeX Warning: Hyper reference `FitsChan' on page 957 undefined on input line 5 3689. LaTeX Warning: Hyper reference `WcsMap' on page 957 undefined on input line 537 06. LaTeX Warning: Hyper reference `Projection' on page 957 undefined on input line 53707. LaTeX Warning: Hyper reference `PVi_m' on page 957 undefined on input line 5370 8. LaTeX Warning: Hyper reference `Warnings' on page 957 undefined on input line 5 3721. [957] LaTeX Warning: Hyper reference `PolyTan' on page 958 undefined on input line 53 732. LaTeX Warning: Hyper reference `FrameSet' on page 958 undefined on input line 5 3738. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3739. LaTeX Warning: Hyper reference `Frame' on page 958 undefined on input line 5374 1. LaTeX Warning: Hyper reference `SpecFrame' on page 958 undefined on input line 53741. LaTeX Warning: Hyper reference `Table' on page 958 undefined on input line 5374 3. LaTeX Warning: Reference `tab:fitspaper3' on page 958 undefined on input line 5 3743. LaTeX Warning: Hyper reference `TabOK' on page 958 undefined on input line 5375 8. LaTeX Warning: Hyper reference `System' on page 958 undefined on input line 537 58. LaTeX Warning: Hyper reference `Mapping' on page 958 undefined on input line 53 758. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 958 undefined on inpu t line 53762. Underfull \hbox (badness 4713) in paragraph at lines 53762--53762 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the LaTeX Warning: Hyper reference `GrismMap' on page 958 undefined on input line 5 3766. LaTeX Warning: Hyper reference `StdOfRest' on page 958 undefined on input line 53771. Underfull \hbox (badness 3229) in paragraph at lines 53771--53772 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the LaTeX Warning: Hyper reference `ObsLon' on page 958 undefined on input line 537 79. LaTeX Warning: Hyper reference `ObsLat' on page 958 undefined on input line 537 79. LaTeX Warning: Hyper reference `Epoch' on page 958 undefined on input line 5378 3. Underfull \hbox (badness 2261) in paragraph at lines 53783--53783 []|\T1/ppl/m/n/9 (+20) Used to set the Epoch at-tributes of the LaTeX Warning: Hyper reference `SourceVRF' on page 958 undefined on input line 53788. Underfull \hbox (badness 1931) in paragraph at lines 53788--53789 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the LaTeX Warning: Hyper reference `SourceVel' on page 958 undefined on input line 53797. Underfull \hbox (badness 3657) in paragraph at lines 53797--53798 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the LaTeX Warning: Hyper reference `RestFreq' on page 958 undefined on input line 5 3806. Underfull \hbox (badness 1043) in paragraph at lines 53806--53806 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 53806--53807 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 53812--53812 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 53812--53813 []|\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 53748--53821 [][] LaTeX Warning: Hyper reference `FrameSet' on page 958 undefined on input line 5 3826. LaTeX Warning: Hyper reference `Frame' on page 958 undefined on input line 5382 6. LaTeX Warning: Hyper reference `SpecFrame' on page 958 undefined on input line 53826. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3827. LaTeX Warning: Hyper reference `Mapping' on page 958 undefined on input line 53 828. LaTeX Warning: Hyper reference `GrismMap' on page 958 undefined on input line 5 3836. LaTeX Warning: Hyper reference `TabOK' on page 958 undefined on input line 5384 0. LaTeX Warning: Hyper reference `FitsChan' on page 958 undefined on input line 5 3855. [958] [959] LaTeX Warning: Hyper reference `FrameSet' on page 960 undefined on input line 5 3870. LaTeX Warning: Hyper reference `FitsChan' on page 960 undefined on input line 5 3870. LaTeX Warning: Hyper reference `Mapping' on page 960 undefined on input line 53 872. LaTeX Warning: Hyper reference `FrameSet' on page 960 undefined on input line 5 3894. LaTeX Warning: Hyper reference `FitsChan' on page 960 undefined on input line 5 3894. LaTeX Warning: Hyper reference `PolyMap' on page 960 undefined on input line 53 899. [960] LaTeX Warning: Reference `ss:howto' on page 961 undefined on input line 53919. LaTeX Warning: Hyper reference `astUnformat' on page 961 undefined on input lin e 53923. LaTeX Warning: Hyper reference `Frame' on page 961 undefined on input line 5392 4. LaTeX Warning: Reference `ss:unformattingaxisvalues' on page 961 undefined on i nput line 53925. LaTeX Warning: Hyper reference `astFormat' on page 961 undefined on input line 53926. LaTeX Warning: Reference `ss:unformattingskyaxisvalues' on page 961 undefined o n input line 53929. LaTeX Warning: Hyper reference `SkyFrame' on page 961 undefined on input line 5 3932. LaTeX Warning: Reference `ss:formattingskyaxisvalues' on page 961 undefined on input line 53936. LaTeX Warning: Hyper reference `astMapBox' on page 961 undefined on input line 53941. LaTeX Warning: Hyper reference `Mapping' on page 961 undefined on input line 53 943. LaTeX Warning: Hyper reference `Object' on page 961 undefined on input line 539 47. LaTeX Warning: Hyper reference `IntraMap' on page 961 undefined on input line 5 3947. LaTeX Warning: Reference `ss:intramaps' on page 961 undefined on input line 539 48. LaTeX Warning: Hyper reference `FrameSet' on page 961 undefined on input line 5 3954. LaTeX Warning: Reference `ss:framesetintegrity' on page 961 undefined on input line 53959. LaTeX Warning: Hyper reference `astSimplify' on page 961 undefined on input lin e 53969. LaTeX Warning: Hyper reference `Channel' on page 961 undefined on input line 53 972. [961] LaTeX Warning: Hyper reference `astRead' on page 962 undefined on input line 53 980. LaTeX Warning: Hyper reference `MatrixMap' on page 962 undefined on input line 53987. LaTeX Warning: Hyper reference `Invert' on page 962 undefined on input line 539 88. LaTeX Warning: Hyper reference `astPolyCurve' on page 962 undefined on input li ne 54004. LaTeX Warning: Reference `ss:plottinggeodesics' on page 962 undefined on input line 54006. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 962 undefined on in put line 54008. LaTeX Warning: Hyper reference `Mapping' on page 962 undefined on input line 54 011. LaTeX Warning: Hyper reference `ast_link' on page 962 undefined on input line 5 4014. LaTeX Warning: Hyper reference `ast_link_adam' on page 962 undefined on input l ine 54015. LaTeX Warning: Hyper reference `astMapBox' on page 962 undefined on input line 54020. LaTeX Warning: Hyper reference `Encoding' on page 962 undefined on input line 5 4025. LaTeX Warning: Hyper reference `FitsChan' on page 962 undefined on input line 5 4025. LaTeX Warning: Hyper reference `FrameSet' on page 962 undefined on input line 5 4030. LaTeX Warning: Hyper reference `Frame' on page 962 undefined on input line 5403 1. LaTeX Warning: Hyper reference `Domain' on page 962 undefined on input line 540 32. LaTeX Warning: Reference `ss:domainconventions' on page 962 undefined on input line 54035. LaTeX Warning: Hyper reference `astFindFits' on page 962 undefined on input lin e 54038. LaTeX Warning: Hyper reference `astPutFits' on page 962 undefined on input line 54040. [962] LaTeX Warning: Hyper reference `astSimplify' on page 963 undefined on input lin e 54051. LaTeX Warning: Hyper reference `UnitRadius' on page 963 undefined on input line 54053. LaTeX Warning: Hyper reference `SphMap' on page 963 undefined on input line 540 53. LaTeX Warning: Hyper reference `MatrixMap' on page 963 undefined on input line 54058. LaTeX Warning: Hyper reference `astConvert' on page 963 undefined on input line 54067. LaTeX Warning: Hyper reference `CmpFrame' on page 963 undefined on input line 5 4068. LaTeX Warning: Hyper reference `astResample$<$X$>$' on page 963 undefined on in put line 54079. LaTeX Warning: Hyper reference `Mapping' on page 963 undefined on input line 54 082. LaTeX Warning: Hyper reference `PcdMap' on page 963 undefined on input line 540 84. LaTeX Warning: Hyper reference `FitsChan' on page 963 undefined on input line 5 4088. [963] LaTeX Warning: Hyper reference `MathMap' on page 964 undefined on input line 54 131. LaTeX Warning: Hyper reference `Mapping' on page 964 undefined on input line 54 132. LaTeX Warning: Hyper reference `IntraMap' on page 964 undefined on input line 5 4137. LaTeX Warning: Hyper reference `astIntraReg' on page 964 undefined on input lin e 54137. LaTeX Warning: Hyper reference `IntraFlag' on page 964 undefined on input line 54146. LaTeX Warning: Reference `ss:intraflag' on page 964 undefined on input line 541 49. LaTeX Warning: Hyper reference `Plot' on page 964 undefined on input line 54151 . LaTeX Warning: Hyper reference `Labelling' on page 964 undefined on input line 54160. LaTeX Warning: Hyper reference `FitsChan' on page 964 undefined on input line 5 4162. LaTeX Warning: Hyper reference `Encoding' on page 964 undefined on input line 5 4165. LaTeX Warning: Hyper reference `System' on page 964 undefined on input line 541 68. LaTeX Warning: Hyper reference `SkyFrame' on page 964 undefined on input line 5 4174. [964] LaTeX Warning: Hyper reference `FitsChan' on page 965 undefined on input line 5 4202. LaTeX Warning: Hyper reference `Projection' on page 965 undefined on input line 54217. LaTeX Warning: Hyper reference `PVi_m' on page 965 undefined on input line 5421 8. [965] LaTeX Warning: Hyper reference `Encoding' on page 966 undefined on input line 5 4250. LaTeX Warning: Hyper reference `FrameSet' on page 966 undefined on input line 5 4260. LaTeX Warning: Hyper reference `Object' on page 966 undefined on input line 542 66. LaTeX Warning: Hyper reference `Frame' on page 966 undefined on input line 5426 7. LaTeX Warning: Hyper reference `Warnings' on page 966 undefined on input line 5 4273. LaTeX Warning: Hyper reference `WcsMap' on page 966 undefined on input line 542 79. LaTeX Warning: Hyper reference `astTranN' on page 966 undefined on input line 5 4303. LaTeX Warning: Hyper reference `astMark' on page 966 undefined on input line 54 303. LaTeX Warning: Hyper reference `astPolyCurve' on page 966 undefined on input li ne 54304. LaTeX Warning: Hyper reference `Plot' on page 966 undefined on input line 54309 . [966] LaTeX Warning: Hyper reference `FitsChan' on page 967 undefined on input line 5 4315. LaTeX Warning: Hyper reference `FrameSet' on page 967 undefined on input line 5 4316. LaTeX Warning: Hyper reference `Domain' on page 967 undefined on input line 543 17. LaTeX Warning: Hyper reference `Frame' on page 967 undefined on input line 5431 9. LaTeX Warning: Hyper reference `Ident' on page 967 undefined on input line 5432 5. LaTeX Warning: Hyper reference `SkyFrame' on page 967 undefined on input line 5 4331. LaTeX Warning: Hyper reference `System' on page 967 undefined on input line 543 31. LaTeX Warning: Hyper reference `Warnings' on page 967 undefined on input line 5 4342. LaTeX Warning: Hyper reference `AllWarnings' on page 967 undefined on input lin e 54346. LaTeX Warning: Hyper reference `Title' on page 967 undefined on input line 5435 0. [967] LaTeX Warning: Hyper reference `LatAxis' on page 968 undefined on input line 54 370. LaTeX Warning: Hyper reference `LonAxis' on page 968 undefined on input line 54 370. LaTeX Warning: Hyper reference `Object' on page 968 undefined on input line 543 73. LaTeX Warning: Hyper reference `ID' on page 968 undefined on input line 54374. LaTeX Warning: Hyper reference `Mapping' on page 968 undefined on input line 54 379. LaTeX Warning: Hyper reference `CmpFrame' on page 968 undefined on input line 5 4379. LaTeX Warning: Hyper reference `Frame' on page 968 undefined on input line 5439 0. LaTeX Warning: Hyper reference `astAngle' on page 968 undefined on input line 5 4391. LaTeX Warning: Hyper reference `astOffset2' on page 968 undefined on input line 54396. LaTeX Warning: Hyper reference `astAxDistance' on page 968 undefined on input l ine 54403. LaTeX Warning: Hyper reference `astAxOffset' on page 968 undefined on input lin e 54409. LaTeX Warning: Hyper reference `Plot' on page 968 undefined on input line 54415 . LaTeX Warning: Hyper reference `astGenCurve' on page 968 undefined on input lin e 54416. LaTeX Warning: Hyper reference `Mapping' on page 968 undefined on input line 54 418. LaTeX Warning: Hyper reference `astGrfSet' on page 968 undefined on input line 54424. LaTeX Warning: Hyper reference `ast_link' on page 968 undefined on input line 5 4428. LaTeX Warning: Hyper reference `astGrfPush' on page 968 undefined on input line 54431. LaTeX Warning: Hyper reference `astGrfPop' on page 968 undefined on input line 54431. [968] LaTeX Warning: Hyper reference `IntraMap' on page 969 undefined on input line 5 4444. LaTeX Warning: Hyper reference `FitsChan' on page 969 undefined on input line 5 4447. LaTeX Warning: Hyper reference `SkyFrame' on page 969 undefined on input line 5 4465. LaTeX Warning: Hyper reference `NegLon' on page 969 undefined on input line 544 65. LaTeX Warning: Hyper reference `astAngle' on page 969 undefined on input line 5 4470. LaTeX Warning: Hyper reference `astAxAngle' on page 969 undefined on input line 54470. LaTeX Warning: Hyper reference `astResolve' on page 969 undefined on input line 54470. LaTeX Warning: Hyper reference `astOffset2' on page 969 undefined on input line 54470. LaTeX Warning: Hyper reference `astAxOffset' on page 969 undefined on input lin e 54470. LaTeX Warning: Hyper reference `astAxDistance' on page 969 undefined on input l ine 54471. LaTeX Warning: Hyper reference `Frame' on page 969 undefined on input line 5447 2. LaTeX Warning: Hyper reference `astDecompose' on page 969 undefined on input li ne 54492. LaTeX Warning: Hyper reference `Mapping' on page 969 undefined on input line 54 492. LaTeX Warning: Hyper reference `CmpMap' on page 969 undefined on input line 544 93. LaTeX Warning: Hyper reference `CmpFrame' on page 969 undefined on input line 5 4494. LaTeX Warning: Hyper reference `FitsChan' on page 969 undefined on input line 5 4509. LaTeX Warning: Hyper reference `DefB1950' on page 969 undefined on input line 5 4509. LaTeX Warning: Hyper reference `astWrite' on page 969 undefined on input line 5 4515. LaTeX Warning: Hyper reference `FrameSet' on page 969 undefined on input line 5 4516. [969] LaTeX Warning: Hyper reference `astRead' on page 970 undefined on input line 54 519. LaTeX Warning: Hyper reference `Plot' on page 970 undefined on input line 54531 . LaTeX Warning: Hyper reference `Grid' on page 970 undefined on input line 54535 . LaTeX Warning: Hyper reference `CarLin' on page 970 undefined on input line 545 48. LaTeX Warning: Hyper reference `FitsChan' on page 970 undefined on input line 5 4548. LaTeX Warning: Hyper reference `FrameSet' on page 970 undefined on input line 5 4550. LaTeX Warning: Hyper reference `Mapping' on page 970 undefined on input line 54 554. LaTeX Warning: Hyper reference `astRead' on page 970 undefined on input line 54 557. LaTeX Warning: Hyper reference `Plot' on page 970 undefined on input line 54564 . LaTeX Warning: Hyper reference `astSet' on page 970 undefined on input line 545 73. [970] LaTeX Warning: Hyper reference `FitsChan' on page 971 undefined on input line 5 4585. LaTeX Warning: Hyper reference `FrameSet' on page 971 undefined on input line 5 4586. LaTeX Warning: Hyper reference `astBoundingBox' on page 971 undefined on input line 54593. LaTeX Warning: Hyper reference `Plot' on page 971 undefined on input line 54594 . LaTeX Warning: Hyper reference `Invisible' on page 971 undefined on input line 54597. LaTeX Warning: Hyper reference `FitsChan' on page 971 undefined on input line 5 4620. LaTeX Warning: Hyper reference `astWrite' on page 971 undefined on input line 5 4621. LaTeX Warning: Hyper reference `WcsMap' on page 971 undefined on input line 546 45. [971] LaTeX Warning: Hyper reference `Frame' on page 972 undefined on input line 5465 6. LaTeX Warning: Hyper reference `Top(axis)' on page 972 undefined on input line 54656. LaTeX Warning: Hyper reference `Bottom(axis)' on page 972 undefined on input li ne 54656. LaTeX Warning: Hyper reference `astGrid' on page 972 undefined on input line 54 658. LaTeX Warning: Hyper reference `Frame' on page 972 undefined on input line 5466 4. LaTeX Warning: Hyper reference `Channel' on page 972 undefined on input line 54 668. LaTeX Warning: Hyper reference `FitsChan' on page 972 undefined on input line 5 4669. LaTeX Warning: Hyper reference `Encoding' on page 972 undefined on input line 5 4669. LaTeX Warning: Hyper reference `astShow' on page 972 undefined on input line 54 670. LaTeX Warning: Hyper reference `Domain' on page 972 undefined on input line 546 82. LaTeX Warning: Hyper reference `CmpFrame' on page 972 undefined on input line 5 4682. LaTeX Warning: Hyper reference `astWrite' on page 972 undefined on input line 5 4689. LaTeX Warning: Hyper reference `FrameSet' on page 972 undefined on input line 5 4691. LaTeX Warning: Hyper reference `Current' on page 972 undefined on input line 54 692. LaTeX Warning: Hyper reference `Base' on page 972 undefined on input line 54693 . LaTeX Warning: Hyper reference `SpecFrame' on page 972 undefined on input line 54708. LaTeX Warning: Hyper reference `SpecMap' on page 972 undefined on input line 54 708. LaTeX Warning: Hyper reference `Mapping' on page 972 undefined on input line 54 713. [972] LaTeX Warning: Hyper reference `astConvert' on page 973 undefined on input line 54725. LaTeX Warning: Hyper reference `Axis' on page 973 undefined on input line 54726 . LaTeX Warning: Hyper reference `ZoomMap' on page 973 undefined on input line 54 728. LaTeX Warning: Hyper reference `astSetActiveUnit' on page 973 undefined on inpu t line 54736. LaTeX Warning: Hyper reference `System' on page 973 undefined on input line 547 42. LaTeX Warning: Hyper reference `Epoch' on page 973 undefined on input line 5474 2. LaTeX Warning: Hyper reference `SkyFrame' on page 973 undefined on input line 5 4742. LaTeX Warning: Hyper reference `AlignSystem' on page 973 undefined on input lin e 54747. LaTeX Warning: Hyper reference `astFindFrame' on page 973 undefined on input li ne 54749. LaTeX Warning: Hyper reference `StdOfRest' on page 973 undefined on input line 54756. LaTeX Warning: Hyper reference `Equinox' on page 973 undefined on input line 54 757. LaTeX Warning: Hyper reference `Plot' on page 973 undefined on input line 54768 . [973] LaTeX Warning: Hyper reference `astVersion' on page 974 undefined on input line 54780. LaTeX Warning: Hyper reference `FitsChan' on page 974 undefined on input line 5 4800. LaTeX Warning: Hyper reference `CDMatrix' on page 974 undefined on input line 5 4809. LaTeX Warning: Hyper reference `FrameSet' on page 974 undefined on input line 5 4810. LaTeX Warning: Hyper reference `SkyFrame' on page 974 undefined on input line 5 4834. LaTeX Warning: Hyper reference `System' on page 974 undefined on input line 548 34. LaTeX Warning: Hyper reference `PolyMap' on page 974 undefined on input line 54 851. [974] LaTeX Warning: Hyper reference `Warnings' on page 975 undefined on input line 5 4857. LaTeX Warning: Hyper reference `Encoding' on page 975 undefined on input line 5 4870. LaTeX Warning: Hyper reference `DefB1950' on page 975 undefined on input line 5 4877. LaTeX Warning: Hyper reference `astRate' on page 975 undefined on input line 54 890. LaTeX Warning: Hyper reference `Mapping' on page 975 undefined on input line 54 892. LaTeX Warning: Hyper reference `Frame' on page 975 undefined on input line 5489 6. LaTeX Warning: Hyper reference `Domain' on page 975 undefined on input line 548 96. LaTeX Warning: Hyper reference `CmpFrame' on page 975 undefined on input line 5 4900. LaTeX Warning: Hyper reference `GrismMap' on page 975 undefined on input line 5 4907. [975] LaTeX Warning: Hyper reference `ShiftMap' on page 976 undefined on input line 5 4910. LaTeX Warning: Hyper reference `WinMap' on page 976 undefined on input line 549 11. LaTeX Warning: Hyper reference `Plot' on page 976 undefined on input line 54914 . LaTeX Warning: Hyper reference `SphMap' on page 976 undefined on input line 549 17. LaTeX Warning: Hyper reference `PolarLong' on page 976 undefined on input line 54917. LaTeX Warning: Hyper reference `WcsMap' on page 976 undefined on input line 549 21. LaTeX Warning: Hyper reference `NatLat' on page 976 undefined on input line 549 24. LaTeX Warning: Hyper reference `NatLon' on page 976 undefined on input line 549 24. LaTeX Warning: Hyper reference `astSimplify' on page 976 undefined on input lin e 54935. LaTeX Warning: Hyper reference `CmpMap' on page 976 undefined on input line 549 36. LaTeX Warning: Hyper reference `SlaMap' on page 976 undefined on input line 549 39. LaTeX Warning: Hyper reference `SpecMap' on page 976 undefined on input line 54 942. LaTeX Warning: Hyper reference `XmlChan' on page 976 undefined on input line 54 957. LaTeX Warning: Hyper reference `Channel' on page 976 undefined on input line 54 957. LaTeX Warning: Hyper reference `Plot' on page 976 undefined on input line 54959 . LaTeX Warning: Hyper reference `astPutCards' on page 976 undefined on input lin e 54977. LaTeX Warning: Hyper reference `FitsChan' on page 976 undefined on input line 5 4978. [976] LaTeX Warning: Hyper reference `Plot' on page 977 undefined on input line 54996 . LaTeX Warning: Hyper reference `Escape' on page 977 undefined on input line 549 99. LaTeX Warning: Hyper reference `Tol' on page 977 undefined on input line 55001. LaTeX Warning: Hyper reference `SkyAxis' on page 977 undefined on input line 55 017. LaTeX Warning: Hyper reference `ast_link' on page 977 undefined on input line 5 5030. [977] LaTeX Warning: Hyper reference `astEscapes' on page 978 undefined on input line 55044. LaTeX Warning: Hyper reference `astFormat' on page 978 undefined on input line 55045. LaTeX Warning: Hyper reference `XmlPrefix' on page 978 undefined on input line 55048. LaTeX Warning: Hyper reference `XmlChan' on page 978 undefined on input line 55 048. LaTeX Warning: Hyper reference `XmlFormat' on page 978 undefined on input line 55052. LaTeX Warning: Hyper reference `Mapping' on page 978 undefined on input line 55 055. LaTeX Warning: Hyper reference `TranMap' on page 978 undefined on input line 55 055. LaTeX Warning: Hyper reference `WcsMap' on page 978 undefined on input line 550 59. LaTeX Warning: Hyper reference `SkyFrame' on page 978 undefined on input line 5 5071. LaTeX Warning: Hyper reference `SkyRefIs' on page 978 undefined on input line 5 5074. LaTeX Warning: Hyper reference `AlignOffset' on page 978 undefined on input lin e 55074. LaTeX Warning: Hyper reference `FitsChan' on page 978 undefined on input line 5 5076. LaTeX Warning: Hyper reference `Iwc' on page 978 undefined on input line 55081. [978] LaTeX Warning: Hyper reference `Mapping' on page 979 undefined on input line 55 128. LaTeX Warning: Hyper reference `astLinearApprox' on page 979 undefined on input line 55129. LaTeX Warning: Hyper reference `SkyFrame' on page 979 undefined on input line 5 5135. LaTeX Warning: Hyper reference `Frame' on page 979 undefined on input line 5513 5. LaTeX Warning: Hyper reference `Plot' on page 979 undefined on input line 55140 . LaTeX Warning: Hyper reference `DSBSpecFrame' on page 979 undefined on input li ne 55149. LaTeX Warning: Hyper reference `SpecFrame' on page 979 undefined on input line 55150. LaTeX Warning: Hyper reference `FitsChan' on page 979 undefined on input line 5 5153. LaTeX Warning: Hyper reference `Encoding' on page 979 undefined on input line 5 5157. LaTeX Warning: Hyper reference `Region' on page 979 undefined on input line 551 73. [979] LaTeX Warning: Hyper reference `Frame' on page 980 undefined on input line 5518 1. LaTeX Warning: Hyper reference `FluxFrame' on page 980 undefined on input line 55181. LaTeX Warning: Hyper reference `SpecFluxFrame' on page 980 undefined on input l ine 55185. LaTeX Warning: Hyper reference `Mapping' on page 980 undefined on input line 55 189. LaTeX Warning: Hyper reference `RateMap' on page 980 undefined on input line 55 189. LaTeX Warning: Hyper reference `SkyFrame' on page 980 undefined on input line 5 5195. LaTeX Warning: Hyper reference `System' on page 980 undefined on input line 551 95. LaTeX Warning: Hyper reference `KeyMap' on page 980 undefined on input line 551 99. LaTeX Warning: Hyper reference `astRate' on page 980 undefined on input line 55 204. LaTeX Warning: Hyper reference `FitsChan' on page 980 undefined on input line 5 5211. LaTeX Warning: Hyper reference `SkyFrame' on page 980 undefined on input line 5 5224. LaTeX Warning: Hyper reference `Frame' on page 980 undefined on input line 5522 7. LaTeX Warning: Hyper reference `Plot' on page 980 undefined on input line 55229 . LaTeX Warning: Hyper reference `Clip' on page 980 undefined on input line 55229 . LaTeX Warning: Hyper reference `PolyMap' on page 980 undefined on input line 55 232. LaTeX Warning: Hyper reference `Channel' on page 980 undefined on input line 55 233. LaTeX Warning: Hyper reference `FitsChan' on page 980 undefined on input line 5 5234. [980] LaTeX Warning: Hyper reference `ast_link' on page 981 undefined on input line 5 5243. LaTeX Warning: Hyper reference `TimeFrame' on page 981 undefined on input line 55259. LaTeX Warning: Hyper reference `TimeMap' on page 981 undefined on input line 55 259. LaTeX Warning: Hyper reference `Frame' on page 981 undefined on input line 5526 0. LaTeX Warning: Hyper reference `Epoch' on page 981 undefined on input line 5526 2. LaTeX Warning: Hyper reference `Mapping' on page 981 undefined on input line 55 263. LaTeX Warning: Hyper reference `XmlChan' on page 981 undefined on input line 55 279. LaTeX Warning: Hyper reference `Mapping' on page 981 undefined on input line 55 283. Overfull \hbox (36.88722pt too wide) in paragraph at lines 55282--55285 \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 981 undefined on input line 5 5304. LaTeX Warning: Hyper reference `System' on page 981 undefined on input line 553 04. [981] LaTeX Warning: Hyper reference `FitsChan' on page 982 undefined on input line 5 5307. LaTeX Warning: Hyper reference `Frame' on page 982 undefined on input line 5531 0. LaTeX Warning: Hyper reference `ObsLon' on page 982 undefined on input line 553 10. LaTeX Warning: Hyper reference `ObsLat' on page 982 undefined on input line 553 10. LaTeX Warning: Hyper reference `TimeFrame' on page 982 undefined on input line 55314. LaTeX Warning: Hyper reference `SpecFrame' on page 982 undefined on input line 55315. LaTeX Warning: Hyper reference `astMapSplit' on page 982 undefined on input lin e 55322. LaTeX Warning: Hyper reference `Mapping' on page 982 undefined on input line 55 323. LaTeX Warning: Hyper reference `SkyRefIs' on page 982 undefined on input line 5 5327. LaTeX Warning: Hyper reference `SideBand' on page 982 undefined on input line 5 5342. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 982 undefined on input li ne 55342. LaTeX Warning: Hyper reference `FitsChan' on page 982 undefined on input line 5 5347. LaTeX Warning: Hyper reference `FrameSet' on page 982 undefined on input line 5 5350. LaTeX Warning: Hyper reference `astRetainFits' on page 982 undefined on input l ine 55353. LaTeX Warning: Hyper reference `Object' on page 982 undefined on input line 553 55. LaTeX Warning: Hyper reference `ObjSize' on page 982 undefined on input line 55 362. LaTeX Warning: Hyper reference `Class' on page 982 undefined on input line 5536 3. LaTeX Warning: Hyper reference `Channel' on page 982 undefined on input line 55 366. [982] LaTeX Warning: Hyper reference `astTune' on page 983 undefined on input line 55 369. LaTeX Warning: Hyper reference `astTranGrid' on page 983 undefined on input lin e 55375. LaTeX Warning: Hyper reference `Mapping' on page 983 undefined on input line 55 376. LaTeX Warning: Hyper reference `SwitchMap' on page 983 undefined on input line 55382. LaTeX Warning: Hyper reference `SelectorMap' on page 983 undefined on input lin e 55387. LaTeX Warning: Hyper reference `Region' on page 983 undefined on input line 553 89. LaTeX Warning: Hyper reference `astConvert' on page 983 undefined on input line 55393. LaTeX Warning: Hyper reference `CmpFrame' on page 983 undefined on input line 5 5394. LaTeX Warning: Hyper reference `Frame' on page 983 undefined on input line 5539 4. LaTeX Warning: Hyper reference `SkyFrame' on page 983 undefined on input line 5 5398. LaTeX Warning: Hyper reference `SpecFrame' on page 983 undefined on input line 55399. LaTeX Warning: Hyper reference `ast_link_adam' on page 983 undefined on input l ine 55402. LaTeX Warning: Hyper reference `ast_link' on page 983 undefined on input line 5 5402. LaTeX Warning: Hyper reference `SpecFrame' on page 983 undefined on input line 55420. LaTeX Warning: Hyper reference `SourceSys' on page 983 undefined on input line 55420. LaTeX Warning: Hyper reference `SourceVel' on page 983 undefined on input line 55421. LaTeX Warning: Hyper reference `astFindFrame' on page 983 undefined on input li ne 55438. LaTeX Warning: Hyper reference `CmpFrame' on page 983 undefined on input line 5 5439. LaTeX Warning: Hyper reference `Frame' on page 983 undefined on input line 5544 0. LaTeX Warning: Hyper reference `SkyFrame' on page 983 undefined on input line 5 5440. LaTeX Warning: Hyper reference `TimeFrame' on page 983 undefined on input line 55440. LaTeX Warning: Hyper reference `SpecFrame' on page 983 undefined on input line 55440. LaTeX Warning: Hyper reference `DSBSpecFrame' on page 983 undefined on input li ne 55440. LaTeX Warning: Hyper reference `FluxFrame' on page 983 undefined on input line 55441. LaTeX Warning: Hyper reference `FrameSet' on page 983 undefined on input line 5 5444. LaTeX Warning: Hyper reference `Mapping' on page 983 undefined on input line 55 447. LaTeX Warning: Hyper reference `PermMap' on page 983 undefined on input line 55 447. LaTeX Warning: Hyper reference `MaxAxes' on page 983 undefined on input line 55 450. LaTeX Warning: Hyper reference `MinAxes' on page 983 undefined on input line 55 450. [983] LaTeX Warning: Hyper reference `SideBand' on page 984 undefined on input line 5 5460. LaTeX Warning: Hyper reference `astConvert' on page 984 undefined on input line 55462. LaTeX Warning: Hyper reference `Dut1' on page 984 undefined on input line 55464 . LaTeX Warning: Hyper reference `ObsLat' on page 984 undefined on input line 554 68. LaTeX Warning: Hyper reference `ObsLon' on page 984 undefined on input line 554 69. LaTeX Warning: Hyper reference `AlignOffset' on page 984 undefined on input lin e 55471. LaTeX Warning: Hyper reference `UnitMap' on page 984 undefined on input line 55 476. LaTeX Warning: Hyper reference `Plot' on page 984 undefined on input line 55478 . LaTeX Warning: Hyper reference `FrameSet' on page 984 undefined on input line 5 5498. LaTeX Warning: Hyper reference `astWrite' on page 984 undefined on input line 5 5499. [984] LaTeX Warning: Hyper reference `astPurgeWCS' on page 985 undefined on input lin e 55508. LaTeX Warning: Hyper reference `FitsChan' on page 985 undefined on input line 5 5509. LaTeX Warning: Hyper reference `Plot' on page 985 undefined on input line 55512 . LaTeX Warning: Hyper reference `astGrfSet' on page 985 undefined on input line 55515. LaTeX Warning: Hyper reference `Frame' on page 985 undefined on input line 5553 7. LaTeX Warning: Hyper reference `astShowMesh' on page 985 undefined on input lin e 55543. LaTeX Warning: Hyper reference `Region' on page 985 undefined on input line 555 44. LaTeX Warning: Hyper reference `TimeFrame' on page 985 undefined on input line 55566. LaTeX Warning: Hyper reference `LTOffset' on page 985 undefined on input line 5 5568. LaTeX Warning: Hyper reference `Plot3D' on page 985 undefined on input line 555 70. [985] LaTeX Warning: Hyper reference `ObsLat' on page 986 undefined on input line 555 75. LaTeX Warning: Hyper reference `Frame' on page 986 undefined on input line 5557 5. LaTeX Warning: Hyper reference `SkyFrame' on page 986 undefined on input line 5 5579. LaTeX Warning: Hyper reference `astLock' on page 986 undefined on input line 55 597. LaTeX Warning: Hyper reference `astUnlock' on page 986 undefined on input line 55597. LaTeX Warning: Hyper reference `Object' on page 986 undefined on input line 555 97. LaTeX Warning: Hyper reference `TimeFrame' on page 986 undefined on input line 55600. LaTeX Warning: Hyper reference `LTOffset' on page 986 undefined on input line 5 5602. LaTeX Warning: Hyper reference `Channel' on page 986 undefined on input line 55 604. LaTeX Warning: Hyper reference `Strict' on page 986 undefined on input line 556 04. LaTeX Warning: Hyper reference `astUnlock' on page 986 undefined on input line 55620. LaTeX Warning: Hyper reference `Object' on page 986 undefined on input line 556 21. LaTeX Warning: Hyper reference `Prism' on page 986 undefined on input line 5562 4. LaTeX Warning: Hyper reference `Region' on page 986 undefined on input line 556 24. LaTeX Warning: Hyper reference `Box' on page 986 undefined on input line 55625. LaTeX Warning: Hyper reference `Interval' on page 986 undefined on input line 5 5625. LaTeX Warning: Hyper reference `astSimplify' on page 986 undefined on input lin e 55633. LaTeX Warning: Hyper reference `PointList' on page 986 undefined on input line 55637. LaTeX Warning: Hyper reference `ListSize' on page 986 undefined on input line 5 5641. [986] LaTeX Warning: Hyper reference `Channel' on page 987 undefined on input line 55 644. LaTeX Warning: Hyper reference `Strict' on page 987 undefined on input line 556 48. LaTeX Warning: Hyper reference `ReportLevel' on page 987 undefined on input lin e 55649. LaTeX Warning: Hyper reference `astWarnings' on page 987 undefined on input lin e 55650. LaTeX Warning: Hyper reference `FitsChan' on page 987 undefined on input line 5 5652. LaTeX Warning: Hyper reference `Frame' on page 987 undefined on input line 5566 0. LaTeX Warning: Hyper reference `astPickAxes' on page 987 undefined on input lin e 55669. LaTeX Warning: Hyper reference `astTestFits' on page 987 undefined on input lin e 55678. LaTeX Warning: Hyper reference `astSetFitsCM' on page 987 undefined on input li ne 55700. LaTeX Warning: Hyper reference `FitsChan' on page 987 undefined on input line 5 5701. LaTeX Warning: Hyper reference `ObsAlt' on page 987 undefined on input line 557 04. LaTeX Warning: Hyper reference `Frame' on page 987 undefined on input line 5570 4. LaTeX Warning: Hyper reference `TimeMap' on page 987 undefined on input line 55 713. LaTeX Warning: Hyper reference `SpecMap' on page 987 undefined on input line 55 713. [987] LaTeX Warning: Hyper reference `Polygon' on page 988 undefined on input line 55 717. LaTeX Warning: Hyper reference `Channel' on page 988 undefined on input line 55 726. LaTeX Warning: Hyper reference `StcsChan' on page 988 undefined on input line 5 5726. LaTeX Warning: Hyper reference `astRemoveRegions' on page 988 undefined on inpu t line 55730. LaTeX Warning: Hyper reference `Mapping' on page 988 undefined on input line 55 731. LaTeX Warning: Hyper reference `Region' on page 988 undefined on input line 557 32. LaTeX Warning: Hyper reference `astDownsize' on page 988 undefined on input lin e 55738. LaTeX Warning: Hyper reference `KeyMap' on page 988 undefined on input line 557 53. LaTeX Warning: Hyper reference `KeyError' on page 988 undefined on input line 5 5756. LaTeX Warning: Hyper reference `Class' on page 988 undefined on input line 5575 6. LaTeX Warning: Hyper reference `Frame' on page 988 undefined on input line 5577 1. LaTeX Warning: Hyper reference `astFindFrame' on page 988 undefined on input li ne 55772. LaTeX Warning: Hyper reference `astConvert' on page 988 undefined on input line 55772. LaTeX Warning: Hyper reference `Domain' on page 988 undefined on input line 557 75. LaTeX Warning: Hyper reference `SkyFrame' on page 988 undefined on input line 5 5777. LaTeX Warning: Hyper reference `UnitMap' on page 988 undefined on input line 55 778. LaTeX Warning: Hyper reference `astMatchAxes' on page 988 undefined on input li ne 55784. LaTeX Warning: Hyper reference `astAddFrame' on page 988 undefined on input lin e 55789. LaTeX Warning: Hyper reference `FrameSet' on page 988 undefined on input line 5 5790. [988] LaTeX Warning: Hyper reference `KeyMap' on page 989 undefined on input line 558 03. LaTeX Warning: Hyper reference `astMapPutU' on page 989 undefined on input line 55805. LaTeX Warning: Hyper reference `astMapCopy' on page 989 undefined on input line 55813. LaTeX Warning: Hyper reference `MapLocked' on page 989 undefined on input line 55816. LaTeX Warning: Hyper reference `Object' on page 989 undefined on input line 558 23. LaTeX Warning: Hyper reference `astHasAttribute' on page 989 undefined on input line 55823. LaTeX Warning: Hyper reference `SkyFrame' on page 989 undefined on input line 5 5827. LaTeX Warning: Hyper reference `StcsChan' on page 989 undefined on input line 5 5840. LaTeX Warning: Hyper reference `Mapping' on page 989 undefined on input line 55 843. LaTeX Warning: Hyper reference `astQuadApprox' on page 989 undefined on input l ine 55844. LaTeX Warning: Hyper reference `astSkyOffsetMap' on page 989 undefined on input line 55848. LaTeX Warning: Hyper reference `Channel' on page 989 undefined on input line 55 852. LaTeX Warning: Hyper reference `Indent' on page 989 undefined on input line 558 52. LaTeX Warning: Hyper reference `astWrite' on page 989 undefined on input line 5 5854. [989] LaTeX Warning: Hyper reference `DSBSpecFrame' on page 990 undefined on input li ne 55871. LaTeX Warning: Hyper reference `FitsChan' on page 990 undefined on input line 5 5884. LaTeX Warning: Hyper reference `astSet' on page 990 undefined on input line 558 89. LaTeX Warning: Hyper reference `FrameSet' on page 990 undefined on input line 5 5896. LaTeX Warning: Hyper reference `astRead' on page 990 undefined on input line 55 896. LaTeX Warning: Hyper reference `KeyMap' on page 990 undefined on input line 558 98. LaTeX Warning: Hyper reference `SortBy' on page 990 undefined on input line 558 98. LaTeX Warning: Hyper reference `astMapKey' on page 990 undefined on input line 55900. LaTeX Warning: Hyper reference `FitsChan' on page 990 undefined on input line 5 5920. LaTeX Warning: Hyper reference `TabOK' on page 990 undefined on input line 5592 2. LaTeX Warning: Hyper reference `Table' on page 990 undefined on input line 5592 5. LaTeX Warning: Hyper reference `KeyMap' on page 990 undefined on input line 559 25. LaTeX Warning: Hyper reference `FitsTable' on page 990 undefined on input line 55928. LaTeX Warning: Hyper reference `KeyCase' on page 990 undefined on input line 55 936. LaTeX Warning: Hyper reference `astMapRename' on page 990 undefined on input li ne 55944. [990] LaTeX Warning: Hyper reference `FitsChan' on page 991 undefined on input line 5 5955. LaTeX Warning: Hyper reference `TabOK' on page 991 undefined on input line 5595 5. LaTeX Warning: Hyper reference `astWrite' on page 991 undefined on input line 5 5958. LaTeX Warning: Hyper reference `astRead' on page 991 undefined on input line 55 966. LaTeX Warning: Hyper reference `astBBuf' on page 991 undefined on input line 55 981. LaTeX Warning: Hyper reference `astEBuf' on page 991 undefined on input line 55 981. LaTeX Warning: Hyper reference `Plot' on page 991 undefined on input line 55982 . LaTeX Warning: Hyper reference `ast_link' on page 991 undefined on input line 5 5986. LaTeX Warning: Hyper reference `astGetRegionMesh' on page 991 undefined on inpu t line 55998. LaTeX Warning: Hyper reference `Region' on page 991 undefined on input line 560 00. LaTeX Warning: Hyper reference `Table' on page 991 undefined on input line 5601 3. [991] LaTeX Warning: Hyper reference `astFindFrame' on page 992 undefined on input li ne 56019. LaTeX Warning: Hyper reference `Frame' on page 992 undefined on input line 5602 0. LaTeX Warning: Hyper reference `SkyFrame' on page 992 undefined on input line 5 6022. LaTeX Warning: Hyper reference `FitsChan' on page 992 undefined on input line 5 6034. LaTeX Warning: Hyper reference `PolyTan' on page 992 undefined on input line 56 046. LaTeX Warning: Hyper reference `PolyMap' on page 992 undefined on input line 56 052. LaTeX Warning: Hyper reference `astPolyTran' on page 992 undefined on input lin e 56053. LaTeX Warning: Hyper reference `Channel' on page 992 undefined on input line 56 067. LaTeX Warning: Hyper reference `SourceFile' on page 992 undefined on input line 56070. LaTeX Warning: Hyper reference `SinkFile' on page 992 undefined on input line 5 6070. LaTeX Warning: Hyper reference `FitsChan' on page 992 undefined on input line 5 6072. LaTeX Warning: Hyper reference `FrameSet' on page 992 undefined on input line 5 6073. LaTeX Warning: Hyper reference `astRead' on page 992 undefined on input line 56 075. LaTeX Warning: Hyper reference `PolyMap' on page 992 undefined on input line 56 078. [992] LaTeX Warning: Hyper reference `Object' on page 993 undefined on input line 560 91. LaTeX Warning: Hyper reference `astToString' on page 993 undefined on input lin e 56091. LaTeX Warning: Hyper reference `astFromString' on page 993 undefined on input l ine 56093. LaTeX Warning: Hyper reference `PolyMap' on page 993 undefined on input line 56 096. LaTeX Warning: Hyper reference `FitsChan' on page 993 undefined on input line 5 6100. LaTeX Warning: Hyper reference `astWriteFits' on page 993 undefined on input li ne 56101. LaTeX Warning: Hyper reference `SinkFile' on page 993 undefined on input line 5 6103. LaTeX Warning: Hyper reference `Nkey' on page 993 undefined on input line 56107 . LaTeX Warning: Hyper reference `CardType' on page 993 undefined on input line 5 6114. LaTeX Warning: Hyper reference `astReadFits' on page 993 undefined on input lin e 56118. LaTeX Warning: Hyper reference `astRead' on page 993 undefined on input line 56 122. LaTeX Warning: Hyper reference `FitsChan' on page 993 undefined on input line 5 6141. LaTeX Warning: Hyper reference `Plot' on page 993 undefined on input line 56146 . LaTeX Warning: Hyper reference `astTuneC' on page 993 undefined on input line 5 6152. [993] LaTeX Warning: Hyper reference `FitsChan' on page 994 undefined on input line 5 6163. LaTeX Warning: Hyper reference `AlignSystem' on page 994 undefined on input lin e 56168. LaTeX Warning: Hyper reference `CmpFrame' on page 994 undefined on input line 5 6225. LaTeX Warning: Hyper reference `SkyFrame' on page 994 undefined on input line 5 6227. [994] LaTeX Warning: Hyper reference `CmpRegion' on page 995 undefined on input line 56230. LaTeX Warning: Hyper reference `Region' on page 995 undefined on input line 562 31. LaTeX Warning: Hyper reference `Plot3D' on page 995 undefined on input line 562 35. LaTeX Warning: Hyper reference `FitsChan' on page 995 undefined on input line 5 6265. LaTeX Warning: Hyper reference `FrameSet' on page 995 undefined on input line 5 6282. [995] LaTeX Warning: Hyper reference `astAddFrame' on page 996 undefined on input lin e 56307. LaTeX Warning: Hyper reference `FrameSet' on page 996 undefined on input line 5 6308. LaTeX Warning: Hyper reference `astRate' on page 996 undefined on input line 56 313. LaTeX Warning: Hyper reference `FitsChan' on page 996 undefined on input line 5 6325. LaTeX Warning: Hyper reference `SkyFrame' on page 996 undefined on input line 5 6325. LaTeX Warning: Hyper reference `SkyRefIs' on page 996 undefined on input line 5 6326. LaTeX Warning: Hyper reference `FrameSet' on page 996 undefined on input line 5 6332. LaTeX Warning: Hyper reference `Frame' on page 996 undefined on input line 5633 3. LaTeX Warning: Hyper reference `System' on page 996 undefined on input line 563 34. LaTeX Warning: Hyper reference `astMapDefined' on page 996 undefined on input l ine 56346. LaTeX Warning: Hyper reference `KeyMap' on page 996 undefined on input line 563 47. LaTeX Warning: Hyper reference `FrameSet' on page 996 undefined on input line 5 6366. LaTeX Warning: Hyper reference `Frame' on page 996 undefined on input line 5636 6. LaTeX Warning: Hyper reference `Mapping' on page 996 undefined on input line 56 369. LaTeX Warning: Hyper reference `Variant' on page 996 undefined on input line 56 369. [996] LaTeX Warning: Hyper reference `Ident' on page 997 undefined on input line 5637 2. LaTeX Warning: Hyper reference `astSimplify' on page 997 undefined on input lin e 56374. LaTeX Warning: Hyper reference `KeyMap' on page 997 undefined on input line 564 02. LaTeX Warning: Hyper reference `SortBy' on page 997 undefined on input line 564 04. LaTeX Warning: Hyper reference `FitsChan' on page 997 undefined on input line 5 6406. LaTeX Warning: Hyper reference `FitsChan' on page 997 undefined on input line 5 6419. LaTeX Warning: Hyper reference `CardName' on page 997 undefined on input line 5 6419. LaTeX Warning: Hyper reference `CardComm' on page 997 undefined on input line 5 6419. [997] LaTeX Warning: Hyper reference `SimpVertices' on page 998 undefined on input li ne 56440. LaTeX Warning: Hyper reference `Polygon' on page 998 undefined on input line 56 443. LaTeX Warning: Hyper reference `PolyMap' on page 998 undefined on input line 56 459. LaTeX Warning: Hyper reference `Base' on page 998 undefined on input line 56476 . LaTeX Warning: Hyper reference `Current' on page 998 undefined on input line 56 476. LaTeX Warning: Hyper reference `FrameSet' on page 998 undefined on input line 5 6476. LaTeX Warning: Hyper reference `Domain' on page 998 undefined on input line 564 77. LaTeX Warning: Hyper reference `Frame' on page 998 undefined on input line 5647 7. LaTeX Warning: Hyper reference `astWrite' on page 998 undefined on input line 5 6478. LaTeX Warning: Hyper reference `FitsAxisOrder' on page 998 undefined on input l ine 56479. LaTeX Warning: Hyper reference `astAppendString' on page 998 undefined on input line 56481. LaTeX Warning: Hyper reference `astAppendString' on page 998 undefined on input line 56494. LaTeX Warning: Hyper reference `astAppendStringf' on page 998 undefined on inpu t line 56495. [998] LaTeX Warning: Hyper reference `astTranGrid' on page 999 undefined on input lin e 56509. LaTeX Warning: Hyper reference `astAddFrame' on page 999 undefined on input lin e 56528. LaTeX Warning: Hyper reference `FrameSet' on page 999 undefined on input line 5 6529. LaTeX Warning: Hyper reference `Mapping' on page 999 undefined on input line 56 529. LaTeX Warning: Hyper reference `Frame' on page 999 undefined on input line 5653 0. LaTeX Warning: Hyper reference `astRegionOutline' on page 999 undefined on inpu t line 56542. LaTeX Warning: Hyper reference `Plot' on page 999 undefined on input line 56543 . LaTeX Warning: Hyper reference `Region' on page 999 undefined on input line 565 44. LaTeX Warning: Hyper reference `SkyFrame' on page 999 undefined on input line 5 6555. [999] LaTeX Warning: Hyper reference `LutMap' on page 1000 undefined on input line 56 560. LaTeX Warning: Hyper reference `LutEpsilon' on page 1000 undefined on input lin e 56560. LaTeX Warning: Hyper reference `SkyFrame' on page 1000 undefined on input line 56573. LaTeX Warning: Hyper reference `SkyTol' on page 1000 undefined on input line 56 573. LaTeX Warning: Hyper reference `Mapping' on page 1000 undefined on input line 5 6575. LaTeX Warning: Hyper reference `FitsChan' on page 1000 undefined on input line 56578. LaTeX Warning: Hyper reference `Warnings' on page 1000 undefined on input line 56585. LaTeX Warning: Hyper reference `astWarnings' on page 1000 undefined on input li ne 56586. LaTeX Warning: Hyper reference `Mapping' on page 1000 undefined on input line 5 6611. LaTeX Warning: Hyper reference `UnitNormMap' on page 1000 undefined on input li ne 56611. LaTeX Warning: Hyper reference `GrismMap' on page 1000 undefined on input line 56626. LaTeX Warning: Hyper reference `LutMap' on page 1000 undefined on input line 56 626. LaTeX Warning: Hyper reference `PcdMap' on page 1000 undefined on input line 56 626. LaTeX Warning: Hyper reference `SphMap' on page 1000 undefined on input line 56 626. LaTeX Warning: Hyper reference `WcsMap' on page 1000 undefined on input line 56 626. LaTeX Warning: Hyper reference `ZoomMap' on page 1000 undefined on input line 5 6626. [1000] LaTeX Warning: Hyper reference `astAxNorm' on page 1001 undefined on input line 56637. LaTeX Warning: Hyper reference `Frame' on page 1001 undefined on input line 566 38. LaTeX Warning: Hyper reference `astGetRegionBounds' on page 1001 undefined on i nput line 56643. LaTeX Warning: Hyper reference `NormMap' on page 1001 undefined on input line 5 6659. LaTeX Warning: Hyper reference `Frame' on page 1001 undefined on input line 566 61. LaTeX Warning: Hyper reference `UnitMap' on page 1001 undefined on input line 5 6662. LaTeX Warning: Hyper reference `astTimeAdd' on page 1001 undefined on input lin e 56664. LaTeX Warning: Hyper reference `TimeMap' on page 1001 undefined on input line 5 6665. LaTeX Warning: Hyper reference `astSlaAdd' on page 1001 undefined on input line 56669. LaTeX Warning: Hyper reference `SlaMap' on page 1001 undefined on input line 56 670. LaTeX Warning: Hyper reference `astSpecAdd' on page 1001 undefined on input lin e 56674. LaTeX Warning: Hyper reference `SpecMap' on page 1001 undefined on input line 5 6675. LaTeX Warning: Hyper reference `astMapRegion' on page 1001 undefined on input l ine 56686. LaTeX Warning: Hyper reference `Region' on page 1001 undefined on input line 56 687. LaTeX Warning: Hyper reference `Mapping' on page 1001 undefined on input line 5 6689. [1001] LaTeX Warning: Hyper reference `Mapping' on page 1002 undefined on input line 5 6703. LaTeX Warning: Hyper reference `ChebyMap' on page 1002 undefined on input line 56703. LaTeX Warning: Hyper reference `PolyMap' on page 1002 undefined on input line 5 6706. LaTeX Warning: Hyper reference `TranForward' on page 1002 undefined on input li ne 56707. LaTeX Warning: Hyper reference `TranInverse' on page 1002 undefined on input li ne 56707. LaTeX Warning: Hyper reference `KeyMap' on page 1002 undefined on input line 56 710. LaTeX Warning: Hyper reference `astMapGetC' on page 1002 undefined on input lin e 56711. LaTeX Warning: Hyper reference `astSetPutErr' on page 1002 undefined on input l ine 56720. LaTeX Warning: Hyper reference `Frame' on page 1002 undefined on input line 567 25. LaTeX Warning: Hyper reference `Epoch' on page 1002 undefined on input line 567 27. LaTeX Warning: Hyper reference `TimeMap' on page 1002 undefined on input line 5 6732. LaTeX Warning: Hyper reference `Dtai' on page 1002 undefined on input line 5673 3. LaTeX Warning: Hyper reference `astLinearApprox' on page 1002 undefined on inpu t line 56752. LaTeX Warning: Hyper reference `Mapping' on page 1002 undefined on input line 5 6752. [1002] LaTeX Warning: Hyper reference `astWrite' on page 1003 undefined on input line 56760. LaTeX Warning: Hyper reference `FitsChan' on page 1003 undefined on input line 56760. LaTeX Warning: Hyper reference `SipOK' on page 1003 undefined on input line 567 63. LaTeX Warning: Hyper reference `FrameSet' on page 1003 undefined on input line 56764. LaTeX Warning: Hyper reference `PolyMap' on page 1003 undefined on input line 5 6765. LaTeX Warning: Hyper reference `astCreatedAt' on page 1003 undefined on input l ine 56767. LaTeX Warning: Hyper reference `astAddFrame' on page 1003 undefined on input li ne 56776. LaTeX Warning: Hyper reference `Region' on page 1003 undefined on input line 56 788. LaTeX Warning: Hyper reference `FitsChan' on page 1003 undefined on input line 56788. LaTeX Warning: Hyper reference `Mapping' on page 1003 undefined on input line 5 6794. LaTeX Warning: Hyper reference `Region' on page 1003 undefined on input line 56 808. LaTeX Warning: Hyper reference `astGetRegionDisc' on page 1003 undefined on inp ut line 56808. LaTeX Warning: Hyper reference `Moc' on page 1003 undefined on input line 56812 . LaTeX Warning: Hyper reference `Bounded' on page 1003 undefined on input line 5 6816. LaTeX Warning: Hyper reference `SkyFrame' on page 1003 undefined on input line 56817. [1003] LaTeX Warning: Hyper reference `Moc' on page 1004 undefined on input line 56830 . LaTeX Warning: Hyper reference `astGetMocString' on page 1004 undefined on inpu t line 56832. LaTeX Warning: Hyper reference `astAddMocString' on page 1004 undefined on inpu t line 56832. LaTeX Warning: Hyper reference `MocChan' on page 1004 undefined on input line 5 6833. LaTeX Warning: Hyper reference `FitsChan' on page 1004 undefined on input line 56835. LaTeX Warning: Hyper reference `FitsChan' on page 1004 undefined on input line 56883. LaTeX Warning: Hyper reference `ForceTab' on page 1004 undefined on input line 56883. LaTeX Warning: Hyper reference `TabOK' on page 1004 undefined on input line 568 84. LaTeX Warning: Hyper reference `FrameSet' on page 1004 undefined on input line 56885. [1004] LaTeX Warning: Hyper reference `TimeFrame' on page 1005 undefined on input line 56898. LaTeX Warning: Hyper reference `astCurrentTime' on page 1005 undefined on input line 56899. LaTeX Warning: Hyper reference `Region' on page 1005 undefined on input line 56 901. LaTeX Warning: Hyper reference `astPointInRegion' on page 1005 undefined on inp ut line 56901. LaTeX Warning: Hyper reference `FitsChan' on page 1005 undefined on input line 56912. LaTeX Warning: Hyper reference `KeyMap' on page 1005 undefined on input line 56 927. LaTeX Warning: Hyper reference `astMapCopyEntry' on page 1005 undefined on inpu t line 56927. LaTeX Warning: Hyper reference `astSimplify' on page 1005 undefined on input li ne 56931. LaTeX Warning: Hyper reference `Channel' on page 1005 undefined on input line 5 6949. LaTeX Warning: Hyper reference `YamlChan' on page 1005 undefined on input line 56949. [1005] [1006] (./sun211.aux) kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1440 mkdir: cannot create directory ‘././nonexistent’: Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1440 This is METAFONT, Version 2.7182818 (TeX Live 2020/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1440.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [192] [193] [194] [195] [196] [197] [198] [199] [200] [201] [202] [203] [204] [205] [206] [207] [208] [209] [210] [211] [212] [213] [214] [215] [216] [217] [218] [219] [220] [221] [222] [223]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [224] [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236] [237] [238] [239] [240] [241] [242] [243] [244] [245] [246] [247] [248] [249] [250] [251] [252] [253] [254] [255]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150] [151] [152] [153] [154] [155] [156] [157]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [160] [161] [162] [163] [164] [165] [166] [167] [168] [169] [170] [171] [172] [173] [174] [175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186] [187] [188]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [97] [98] [99] [100] [101] [102] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115] [116] [117] [118] [119] [120] [121] [122]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1440.tfm. Output written on ectt1440.600gf (256 characters, 61024 bytes). Transcript written on ectt1440.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1440.600pk: successfully generated. Package rerunfilecheck Warning: File `sun211.out' has changed. (rerunfilecheck) Rerun to get outlines right (rerunfilecheck) or use package `bookmark'. LaTeX Warning: There were undefined references. LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right. ) (\end occurred inside a group at level 1) ### simple group (level 1) entered at line 6736 ({) ### bottom level (see the transcript file for additional information) {/usr/share/texlive/texmf-dist/fonts/enc/dvips/base/8 r.enc} kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1095 mkdir: cannot create directory ‘././nonexistent’: Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1095 This is METAFONT, Version 2.7182818 (TeX Live 2020/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1095.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [192] [193] [194] [195] [196] [197] [198] [199] [200] [201] [202] [203] [204] [205] [206] [207] [208] [209] [210] [211] [212] [213] [214] [215] [216] [217] [218] [219] [220] [221] [222] [223]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [224] [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236] [237] [238] [239] [240] [241] [242] [243] [244] [245] [246] [247] [248] [249] [250] [251] [252] [253] [254] [255]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150] [151] [152] [153] [154] [155] [156] [157]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [160] [161] [162] [163] [164] [165] [166] [167] [168] [169] [170] [171] [172] [173] [174] [175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186] [187] [188]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [97] [98] [99] [100] [101] [102] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115] [116] [117] [118] [119] [120] [121] [122]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1095.tfm. Output written on ectt1095.600gf (256 characters, 47796 bytes). Transcript written on ectt1095.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1095.600pk: successfully generated. kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt1000 mkdir: cannot create directory ‘././nonexistent’: Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt1000 This is METAFONT, Version 2.7182818 (TeX Live 2020/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt1000.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [192] [193] [194] [195] [196] [197] [198] [199] [200] [201] [202] [203] [204] [205] [206] [207] [208] [209] [210] [211] [212] [213] [214] [215] [216] [217] [218] [219] [220] [221] [222] [223]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [224] [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236] [237] [238] [239] [240] [241] [242] [243] [244] [245] [246] [247] [248] [249] [250] [251] [252] [253] [254] [255]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150] [151] [152] [153] [154] [155] [156] [157]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [160] [161] [162] [163] [164] [165] [166] [167] [168] [169] [170] [171] [172] [173] [174] [175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186] [187] [188]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [97] [98] [99] [100] [101] [102] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115] [116] [117] [118] [119] [120] [121] [122]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt1000.tfm. Output written on ectt1000.600gf (256 characters, 43832 bytes). Transcript written on ectt1000.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt1000.600pk: successfully generated. kpathsea: Running mktexpk --mfmode / --bdpi 600 --mag 1+0/600 --dpi 600 ectt0900 mkdir: cannot create directory ‘././nonexistent’: Permission denied mktexpk: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1+0/600; nonstopmode; input ectt0900 This is METAFONT, Version 2.7182818 (TeX Live 2020/Debian) (preloaded base=mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt0900.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbase.mf) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/ectt.mf (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exroman.mf Ok (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccess.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expseudo.mf Ok) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exruwest.mf Ok [192] [193] [194] [195] [196] [197] [198] [199] [200] [201] [202] [203] [204] [205] [206] [207] [208] [209] [210] [211] [212] [213] [214] [215] [216] [217] [218] [219] [220] [221] [222] [223]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlwest.mf Ok [224] [225] [226] [227] [228] [229] [230] [231] [232] [233] [234] [235] [236] [237] [238] [239] [240] [241] [242] [243] [244] [245] [246] [247] [248] [249] [250] [251] [252] [253] [254] [255]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrueast.mf Ok [128] [129] [130] [131] [132] [133] [134] [135] [136] [137] [138] [139] [140] [141] [142] [143] [144] [145] [146] [147] [148] [149] [150] [151] [152] [153] [154] [155] [156] [157]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrleast.mf Ok [158] [160] [161] [162] [163] [164] [165] [166] [167] [168] [169] [170] [171] [172] [173] [174] [175] [176] [177] [178] [179] [180] [181] [182] [183] [184] [185] [186] [187] [188]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exbraces.mf Ok [94] [126] [23] [40] [41] [60] [124] [62] [91] [93] [92] [123] [125] [95] [127] [32]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/expunct.mf Ok [14] [15] [19] [20] [13] [18] [33] [39] [42] [43] [44] [46] [47] [58] [59] [61] [96] [189] [17] [45] [16] [21] [22]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exaccent.mf Ok [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exsign.mf Ok [24] [34] [35] [36] [37] [64] [191] [159]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrlig.mf Ok [25] [26] [28] [27] [29] [30] [31]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exromp.mf Ok [38] [63] [190]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrulett.mf Ok [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrllett.mf Ok [97] [98] [99] [100] [101] [102] [103] [104] [105] [106] [107] [108] [109] [110] [111] [112] [113] [114] [115] [116] [117] [118] [119] [120] [121] [122]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exrdigit.mf Ok [48] [49] [50] [51] [52] [53] [54] [55] [56] [57]) (/usr/share/texlive/texmf-dist/fonts/source/jknappen/ec/exmligtb.mf Ok) ) ) ) Font metrics written on ectt0900.tfm. Output written on ectt0900.600gf (256 characters, 39464 bytes). Transcript written on ectt0900.log. mktexpk: /tmp/texfonts/pk/ljfour/jknappen/ec/ectt0900.600pk: successfully generated. Output written on sun211.pdf (1010 pages, 2514434 bytes). Transcript written on sun211.log. This is pdfTeX, Version 3.14159265-2.6-1.40.21 (TeX Live 2020/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./sun211.tex LaTeX2e <2020-02-02> patch level 5 L3 programming layer <2020-09-24> (./starlink.cls Document Class: starlink ........passing options to article...... (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2019/12/20 v1.4l 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/microtype/microtype-pdftex.def) (/usr/share/texlive/texmf-dist/tex/latex/microtype/microtype.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/mathpazo.sty) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def)) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse-generic.tex)) (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator.sty)) (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def))) (/usr/share/texlive/texmf-dist/tex/latex/multirow/multirow.sty) (/usr/share/texlive/texmf-dist/tex/latex/enumitem/enumitem.sty) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/dvipsnam.def) (/usr/share/texlive/texmf-dist/tex/latex/xcolor/svgnam.def)) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/mdframed.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvsetkeys/kvsetkeys.sty)) (/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty) (/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/infwarerr/infwarerr.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.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/generic/atbegshi/atbegshi.sty)) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty) (/usr/share/texlive/texmf-dist/tex/latex/pgf/frontendlayer/tikz.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgf.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/utilities/pgfrcs.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-common-lists.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfutil-latex.def (/usr/share/texlive/texmf-dist/tex/latex/ms/everyshi.sty)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfrcs.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/pgf.revision.tex))) (/usr/share/texlive/texmf-dist/tex/latex/pgf/basiclayer/pgfcore.sty (/usr/share/texlive/texmf-dist/tex/latex/pgf/systemlayer/pgfsys.sty (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeys.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/utilities/pgfkeysfiltered.code.t ex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgf.cfg) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-pdftex.def (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsys-common-pdf.de f))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsyssoftpath.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/systemlayer/pgfsysprotocol.code. tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/basiclayer/pgfcore.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmath.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathcalc.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathutil.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathparser.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.basic.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.trigonomet ric.code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.random.cod e.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.comparison .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.base.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.round.code .tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.misc.code. tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfunctions.integerari thmetics.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/math/pgfmathfloat.code.tex)) (/usr/share/texlive/texmf-dist/tex/generic/pgf/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/math/pgfmath.code.tex))) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/tikz.code.tex (/usr/share/texlive/texmf-dist/tex/generic/pgf/libraries/pgflibraryplothandlers .code.tex) (/usr/share/texlive/texmf-dist/tex/generic/pgf/modules/pgfmodulematrix.code.tex ) (/usr/share/texlive/texmf-dist/tex/generic/pgf/frontendlayer/tikz/libraries/tik zlibrarytopaths.code.tex))) (/usr/share/texlive/texmf-dist/tex/latex/mdframed/md-frame-1.mdf)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/rotating.sty (/usr/share/texlive/texmf-dist/tex/latex/base/ifthen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/pdflscape/pdflscape.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/letltxmacro/letltxmacro.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/backref.sty (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/latex/atveryend/atveryend.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/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/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)) (./sun211.aux LaTeX Warning: Label `astSet' multiply defined. LaTeX Warning: Label `{xref_changes}' multiply defined. LaTeX Warning: Label `{xref_list_of_most_recent_changes}' multiply defined. ) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-ppl.cfg) (/usr/share/texlive/texmf-dist/tex/latex/translator/translator-basic-dictionary -English.dict) (/usr/share/texlive/texmf-dist/tex/latex/siunitx/siunitx-abbreviations.cfg) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) ABD: EveryShipout initializing macros *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (./sun211.out) (./sun211.out) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1ppl.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omlzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omszplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/omxzplm.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ot1zplm.fd) Underfull \hbox (badness 10000) in paragraph at lines 60--60 Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `\kernel@ifnextchar' on input line 60. [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map} <./sun211_figures/fronta. pdf> <./sun211_figures/frontb.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontb.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page > <./sun211_figures/frontc.pdf pdfTeX warning: pdflatex (file ./sun211_figures/frontc.pdf): PDF inclusion: mul tiple pdfs with page group included in a single page >] [2] (./sun211.toc [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] [20] [21]) [22] (./sun211.lof) [23] [1] (/usr/share/texlive/texmf-dist/tex/latex/base/t1cmtt.fd) (/usr/share/texlive/texmf-dist/tex/latex/psnfss/ts1ppl.fd) [2] [3] [4] [5 <./su n211_figures/mapping.pdf>] Overfull \hbox (16.86678pt too wide) in paragraph at lines 316--318 []\T1/ppl/m/n/10.95 (-20) Various lin-ear co-or-di-nate trans-for-ma-tions (the []Ma-trixMap[], []Win-Map[], []ShiftMap[] and []ZoomMap[]). [6] [7 <./sun211_figures/series.pdf> <./sun211_figures/parallel.pdf>] [8 <./sun 211_figures/complex.pdf>] [9 <./sun211_figures/frames.pdf>] [10 <./sun211_figur es/cmpframe.pdf>] [11 <./sun211_figures/frameset.pdf>] [12] [13 <./sun211_figur es/gridplot_bw.pdf>] [14] [15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27 <./sun211_figures/overgrid_bw.pdf>] [28] [29] [30] [31] [32] [33] [34] [35] [36] [37] [38] [39] [40] [41] [42] [43] [44] [45] [46] [47] [48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61 <./sun211_ figures/simpexamp.pdf>] [62] [63] [64] [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] [75] [76] [77] [78] LaTeX Warning: Float too large for page by 241.1866pt on input line 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 <./sun 211_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 <./su n211_figures/fsconvert.pdf>] [124] [125 <./sun211_figures/fsalign.pdf>] [126] [127] [128] [129 <./sun211_figures/fsremap.pdf>] [130] [131] [132 <./sun2 11_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.34566pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 12193. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.36206pt 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.36206pt 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.36206pt 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.36206pt 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.36206pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 14993. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.86975pt 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 (16.11847pt 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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17484. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 17821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (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.86975pt 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 18434--18434 []\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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 [][]\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 18434--18434 \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 18434--18434 \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 18434--18434 \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 18434--18434 \T1/cmtt/m/n/10 within the new coordinate system may be distorted, and so may n ot match that implied [313] Overfull \hbox (32.0758pt too wide) in paragraph at lines 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 [][]\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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18583--18583 \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 18638--18638 \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 18638--18638 \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 18638--18638 Overfull \hbox (5.62103pt too wide) in paragraph at lines 18638--18638 [][]\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 18674--18674 [][]\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 18711--18711 [][]\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 18754--18754 [][]\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 18754--18754 [][]\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 18754--18754 \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 18810--18810 \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 18810--18810 \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 18810--18810 [][]\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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 [][]\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 18901--18901 \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 18901--18901 \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 18901--18901 \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 18901--18901 [][]\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 18938--18938 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 []\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 19440--19440 []\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 19440--19440 []\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19440--19440 []\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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 \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 19440--19440 [][]\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 19440--19440 \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 19440--19440 [][]\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 19440--19440 \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 19440--19440 []\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 19440--19440 \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 19440--19440 \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 19440--19440 []\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 19440--19440 [][]\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 19440--19440 \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 19440--19440 [][]\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 19440--19440 [][]\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 19485--19485 [][]\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 19485--19485 \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 19485--19485 \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 19485--19485 \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 19485--19485 [][]\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 19485--19485 [][]\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 19485--19485 \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 19552--19552 \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 19552--19552 \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 19552--19552 \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 19552--19552 \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 19552--19552 [][]\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 19552--19552 [][]\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 19619--19619 \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 19619--19619 \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 19619--19619 \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 19619--19619 [] \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 19619--19619 \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 19619--19619 \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 19619--19619 [][]\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 19667--19667 [][]\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 19704--19704 \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 19741--19741 \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 19861--19861 []\T1/cmtt/m/n/10 void astIntersect( AstFrame $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/ n/10 this, const double a1[2], const double a2[2], const double Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the first geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of a second point on the first g eodesic curve. It Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \T1/cmtt/m/n/10 should contain the coordinates of the first point on the second geodesic curve. Overfull \hbox (21.36719pt too wide) in paragraph at lines 19861--19861 [] \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 19861--19861 \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 19861--19861 \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 19861--19861 [][]\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 19861--19861 \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 19861--19861 [][]\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 19861--19861 \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 19861--19861 [][]\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 19994--19994 []\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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 []\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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 []\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 19994--19994 \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 19994--19994 \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 19994--19994 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 \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 19994--19994 [] \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 19994--19994 \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 19994--19994 \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 19994--19994 [][]\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 19994--19994 []\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 19994--19994 \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 20086--20086 []\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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 \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 20086--20086 [] \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 20086--20086 \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 20086--20086 \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 20086--20086 [][]\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 20269--20269 []\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 []\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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \T1/cmtt/m/n/10 forward coordinate transformation, followed immediately by the matching inverse Overfull \hbox (37.11334pt too wide) in paragraph at lines 20269--20269 \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 20269--20269 \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 20269--20269 \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 20269--20269 [][]\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 20269--20269 \T1/cmtt/m/n/10 inverse coordinate transformation, followed immediately by the matching forward Overfull \hbox (37.11334pt too wide) in paragraph at lines 20269--20269 \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 20269--20269 \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 20269--20269 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 20357. Overfull \hbox (3.47949pt too wide) in paragraph at lines 20357--20357 \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 20357--20357 Underfull \hbox (badness 10000) in paragraph at lines 20357--20357 [] \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 20357--20357 [][]\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 20357--20357 [][]\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 20357--20357 \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 20357--20357 [][]\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 20357--20357 \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 20432--20432 \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 20432--20432 \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 20432--20432 \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 20432--20432 [] \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 20432--20432 \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 20432--20432 \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 20432--20432 [][]\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 20432--20432 []\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 20432--20432 \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 20550--20550 []\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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (21.36719pt too wide) in paragraph at lines 20550--20550 [] \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 [] \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 [][]\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 20550--20550 \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 20550--20550 [][]\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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 \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 20550--20550 [][]\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 20550--20550 [][]\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 20550--20550 \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 20550--20550 \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 20628--20628 \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 20628--20628 \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 20628--20628 \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 20628--20628 \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 20628--20628 [][]\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 20628--20628 \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 20628--20628 [][]\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 20628--20628 [][]\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 20628--20628 \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 20628--20628 \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 20628--20628 \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 20628--20628 [][]\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 20628--20628 \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 20739--20739 []\T1/cmtt/m/n/10 AstLutMap $\OMS/zplm/m/n/10 ^^C$\T1/cmtt/m/n/10 astLutMap( in t nlut, const double lut[], double start, double inc, const Overfull \hbox (36.8509pt too wide) in paragraph at lines 20739--20739 \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 20739--20739 \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 20739--20739 \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 20739--20739 \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 20739--20739 \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 20739--20739 [] \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 20739--20739 \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 20739--20739 \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 20739--20739 [][]\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 20739--20739 \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 20739--20739 \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 20739--20739 \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 20739--20739 [][]\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 20739--20739 []\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 20739--20739 \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 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882--20882 []\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \T1/cmtt/m/n/10 Pointer to a double in which to return the highest value taken by the nominated Overfull \hbox (26.6159pt too wide) in paragraph at lines 20882--20882 [] \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 20882--20882 \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 20882--20882 \T1/cmtt/m/n/10 point (although not necessarily a unique one) for which the nom inated output coordinate [352] Overfull \hbox (26.6159pt too wide) in paragraph at lines 20882--20882 [] \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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 \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 20882--20882 [][]\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 20882--20882 \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 20882--20882 \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 20928--20928 [][]\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 20928--20928 [][]\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 20928--20928 \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 20928--20928 \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 20928--20928 \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 20928--20928 [][]\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 20928--20928 \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 20992--20992 []\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 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 \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 20992--20992 [][]\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 20992--20992 [][]\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 20992--20992 [][]\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 20992--20992 \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 21030--21030 \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 21030--21030 \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 21030--21030 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21157. Overfull \hbox (15.85603pt too wide) in paragraph at lines 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 [][]\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 21157--21157 \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 21157--21157 [][]\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 21157--21157 [][]\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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 [][]\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 21157--21157 \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 21157--21157 \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 21157--21157 \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 21157--21157 []\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 21157--21157 \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 21157--21157 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21301. Overfull \hbox (15.56409pt too wide) in paragraph at lines 21301--21301 []\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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \T1/cmtt/m/n/10 The address of an integer in which to put the number of element s stored in the Overfull \hbox (15.85603pt too wide) in paragraph at lines 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 [][]\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 21301--21301 \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 21301--21301 [][]\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 21301--21301 []\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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 []\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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21301--21301 \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 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 [][]\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 21371--21371 \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 21371--21371 [][]\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 21371--21371 \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 21371--21371 \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 21371--21371 \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 21371--21371 \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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21502. Overfull \hbox (5.06665pt too wide) in paragraph at lines 21502--21502 []\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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 [][]\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 21502--21502 \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 21502--21502 []\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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 []\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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21502--21502 \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 21554--21554 \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 21554--21554 \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 21554--21554 [][]\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 21554--21554 \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 21554--21554 [][]\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 21614--21614 \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 21614--21614 \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 21614--21614 [][]\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 21614--21614 \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 21614--21614 \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 21614--21614 [][]\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 21666--21666 \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 21666--21666 \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 21666--21666 \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 21666--21666 [][]\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 21666--21666 [][]\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 21711--21711 \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 21711--21711 \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 21711--21711 \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 21711--21711 [][]\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21821. Overfull \hbox (46.79396pt too wide) in paragraph at lines 21821--21821 []\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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 [][]\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 21821--21821 [][]\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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 \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 21821--21821 []\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 21821--21821 \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 21821--21821 \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 21821--21821 []\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 21925. Overfull \hbox (33.46098pt too wide) in paragraph at lines 21925--21925 []\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 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 \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 21925--21925 [][]\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 21925--21925 []\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 21925--21925 \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 21925--21925 \T1/cmtt/m/n/10 For example, astMapPut1D would be used to store " double" value s, while astMapPut1I Overfull \hbox (7.98578pt too wide) in paragraph at lines 21925--21925 []\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 [370] [371] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22050. Overfull \hbox (4.59303pt too wide) in paragraph at lines 22050--22050 []\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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 [][]\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 22050--22050 [][]\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 22050--22050 \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 22050--22050 []\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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22050--22050 \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 22100--22100 \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 22100--22100 \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 22100--22100 \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 22100--22100 [][]\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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 \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 22168--22168 [][]\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 22168--22168 [][]\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 22197--22197 \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 22197--22197 \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 22234--22234 \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 22234--22234 \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 22234--22234 \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 22234--22234 \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 22268--22268 [][]\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 22351--22351 []\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 22351--22351 [] \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 \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 22351--22351 [][]\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 22351--22351 \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 22410--22410 \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 22410--22410 \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 22410--22410 \T1/cmtt/m/n/10 One of AST__INTTYPE (for integer), AST__SINTTYPE (for short int ), AST__BYTETYPE (for Overfull \hbox (79.10309pt too wide) in paragraph at lines 22410--22410 [][]\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 22410--22410 \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 22410--22410 \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 22410--22410 \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 22410--22410 [][]\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 22496--22496 []\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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 22496--22496 [] \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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 \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 22496--22496 [][]\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 22496--22496 \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 22496--22496 [][]\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 22496--22496 [][]\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 (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 22713. Overfull \hbox (3.90186pt too wide) in paragraph at lines 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 [] \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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 [][]\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 22713--22713 [][]\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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 []\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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22713--22713 \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 22775--22775 \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 22775--22775 \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 22775--22775 \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 22775--22775 []\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 22775--22775 [][]\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 22775--22775 \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 22775--22775 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [] \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 []\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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 \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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 [][]\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 23512--23512 []\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 23512--23512 [][]$\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 23512--23512 \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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 [][]$\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 23512--23512 \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 23512--23512 \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 23512--23512 []\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 23512--23512 \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 23633--23633 []\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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 []\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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 [] \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 23633--23633 \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 23633--23633 \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 23633--23633 [][]\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 23633--23633 \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 23633--23633 \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 23633--23633 [][]\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 23633--23633 \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 23633--23633 \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 23633--23633 \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 23633--23633 [][]\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 23633--23633 []\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 23633--23633 \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 23706--23706 \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 23706--23706 \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 23706--23706 \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 23706--23706 \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 23706--23706 [][]\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 23706--23706 \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 23706--23706 [][]\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 23706--23706 \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 23706--23706 [][]\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 23706--23706 [][]\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 23805--23805 Overfull \hbox (10.86975pt too wide) in paragraph at lines 23805--23805 \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 23805--23805 \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 23805--23805 \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 23805--23805 [] \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 23805--23805 \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 23805--23805 \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 23805--23805 [][]\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 23805--23805 []\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 23805--23805 \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 23912--23912 []\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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 []\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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 []\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 23912--23912 \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 23912--23912 \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 23912--23912 \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 23912--23912 [] \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 23912--23912 \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 23912--23912 \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 23912--23912 [][]\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 23912--23912 \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 23912--23912 [][]\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 23992--23992 \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 23992--23992 \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 23992--23992 \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 23992--23992 \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 23992--23992 [][]\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 23992--23992 \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 23992--23992 \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 23992--23992 [][]\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 23992--23992 [][]\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 23992--23992 \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 24072--24072 \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 24072--24072 \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 24072--24072 \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 24072--24072 \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 24072--24072 [] \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 24072--24072 \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 24072--24072 \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 24072--24072 [][]\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 24072--24072 []\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 24072--24072 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [403] Overfull \hbox (5.73253pt too wide) in paragraph at lines 24157--24157 []\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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 []\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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 \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 24157--24157 [] \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 24157--24157 \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 24157--24157 \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 24157--24157 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [404] Overfull \hbox (42.36206pt too wide) in paragraph at lines 24190--24190 [][]\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 24190--24190 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [405] Overfull \hbox (12.97206pt too wide) in paragraph at lines 24266--24266 []\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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 \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 24266--24266 [][]\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 24266--24266 [][]\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 24266--24266 [][]\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 24266--24266 \T1/cmtt/m/n/10 coincident (or otherwise fail to uniquely specify a geodesic cu rve) but the requested [406] Overfull \hbox (26.3563pt too wide) in paragraph at lines 24352--24352 []\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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 \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 24352--24352 [][]\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 24352--24352 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [407] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 24637. Overfull \hbox (10.58418pt too wide) in paragraph at lines 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \T1/cmtt/m/n/10 Pointer to an array of two integers containing the pixel index of the last pixel [408] Overfull \hbox (0.37231pt too wide) in paragraph at lines 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 [409] Overfull \hbox (26.6159pt too wide) in paragraph at lines 24637--24637 [][]\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 24637--24637 [][]\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 [][]\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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 []\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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 24637--24637 \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 >$ [410] Overfull \hbox (12.76088pt too wide) in paragraph at lines 24703--24703 \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 24703--24703 []\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 24703--24703 []\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 24703--24703 [][]\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 24703--24703 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [411] Overfull \hbox (5.3586pt too wide) in paragraph at lines 24764--24764 \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 24764--24764 [][]\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 24764--24764 \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 24764--24764 \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 24764--24764 [][]\T1/cmtt/m/n/10 A NULL pointer will be returned if this function is invoked with the AST error [412] Overfull \hbox (9.50914pt too wide) in paragraph at lines 24867--24867 []\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 24867--24867 \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 24867--24867 \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 24867--24867 \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 24867--24867 \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 24867--24867 [] \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 24867--24867 \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 24867--24867 \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 24867--24867 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [413] Overfull \hbox (2.26344pt too wide) in paragraph at lines 24867--24867 []\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 24867--24867 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [414] Overfull \hbox (0.10988pt too wide) in paragraph at lines 24906--24906 \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 24906--24906 \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 24906--24906 [][]\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 24906--24906 [][]\T1/cmtt/m/n/10 If successive axis permutations are applied to a Frame, the n the effects are cumulative. [415] Overfull \hbox (5.09898pt too wide) in paragraph at lines 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 []\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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 []\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 25044--25044 \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 25044--25044 []\T1/cmtt/m/n/10 If a NULL pointer is supplied instead of an array, the behavi our is as if the [416] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25044--25044 \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 25044--25044 \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 25044--25044 \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 25044--25044 [] \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 25044--25044 \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 25044--25044 \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 25044--25044 [][]\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 25044--25044 \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 25044--25044 [][]\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 25044--25044 \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 25044--25044 \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 25044--25044 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [417] Overfull \hbox (13.6056pt too wide) in paragraph at lines 25156--25156 []\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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 []\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 25156--25156 Overfull \hbox (23.25832pt too wide) in paragraph at lines 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \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 25156--25156 \T1/cmtt/m/n/10 for success is that no default axes are added (that is, the " a xes" array must not [418] Overfull \hbox (26.6159pt too wide) in paragraph at lines 25156--25156 [][]\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 25156--25156 \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 25156--25156 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [419] Overfull \hbox (7.93452pt too wide) in paragraph at lines 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 []\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 25329--25329 \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 25329--25329 \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 25329--25329 \T1/cmtt/m/n/10 each pair. Note that the order in which these points are given is important because [420] Overfull \hbox (5.3586pt too wide) in paragraph at lines 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [] \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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 \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 25329--25329 [][]\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 25329--25329 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [421] Overfull \hbox (28.9294pt too wide) in paragraph at lines 25465--25465 []\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 []\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 []\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [] \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 25465--25465 \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 25465--25465 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [422] Overfull \hbox (0.10988pt too wide) in paragraph at lines 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 25465--25465 [][]\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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 \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 25465--25465 [][]\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 25465--25465 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [423] Overfull \hbox (26.35347pt too wide) in paragraph at lines 25522--25522 \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 25522--25522 \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 25522--25522 Overfull \hbox (5.62103pt too wide) in paragraph at lines 25522--25522 [][]\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 25522--25522 \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 25522--25522 \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 [424] Overfull \hbox (34.17812pt too wide) in paragraph at lines 25655--25655 []\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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 []\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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 []\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 25655--25655 \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 25655--25655 \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 25655--25655 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 25655--25655 \T1/cmtt/m/n/10 used to determine if the transformed boundary can be accurately represented by [425] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25655--25655 \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 25655--25655 \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 25655--25655 \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 25655--25655 [] \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 25655--25655 \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 25655--25655 \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 25655--25655 [][]\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 25655--25655 []\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 25655--25655 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [426] Overfull \hbox (29.14058pt too wide) in paragraph at lines 25732--25732 []\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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 \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 25732--25732 []\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 25732--25732 \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 25732--25732 \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 25732--25732 \T1/cmtt/m/n/10 is returned if the transformation does not have any defining po lynomials. A value [427] Overfull \hbox (18.43196pt too wide) in paragraph at lines 25809--25809 []\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 25809--25809 \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 25809--25809 \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 25809--25809 \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 25809--25809 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (42.36206pt too wide) in paragraph at lines 25809--25809 [] \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 25809--25809 \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 25809--25809 \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 25809--25809 \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 25809--25809 [][]\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 25809--25809 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [428] Overfull \hbox (12.97206pt too wide) in paragraph at lines 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 []\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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 \T1/cmtt/m/n/10 transposed. If " ncoeff_i" is zero, a NULL pointer may be suppl ied for " coeff_i" [429] Overfull \hbox (10.86975pt too wide) in paragraph at lines 25936--25936 \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 25936--25936 \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 25936--25936 \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 25936--25936 [] \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 25936--25936 \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 25936--25936 \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 25936--25936 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [430] Overfull \hbox (31.86462pt too wide) in paragraph at lines 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \T1/cmtt/m/n/10 inlcuded in the fit. So the maximum number of terms in each of the fitted polynomials [431] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 \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 26111--26111 [][]\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 26111--26111 \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 26111--26111 \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 26111--26111 [][]\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 26111--26111 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [432] Overfull \hbox (50.13545pt too wide) in paragraph at lines 26256--26256 []\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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 []\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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \T1/cmtt/m/n/10 may be supplied, in which case a default uncertainty is used eq uivalent to a box [433] Overfull \hbox (5.3586pt too wide) in paragraph at lines 26256--26256 []\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 26256--26256 \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 26256--26256 \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 26256--26256 \T1/cmtt/m/n/10 system and subsequently simplified (using []astSimplify[]), the uncertainties are Overfull \hbox (5.3586pt too wide) in paragraph at lines 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 \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 26256--26256 [] \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 26256--26256 \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 26256--26256 \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 26256--26256 [][]\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 26256--26256 []\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 26256--26256 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [434] Overfull \hbox (9.9315pt too wide) in paragraph at lines 26335--26335 []\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 26335--26335 \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 26335--26335 \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 26335--26335 \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 26335--26335 [] \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 26335--26335 \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 26335--26335 \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 26335--26335 [][]\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 26335--26335 \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 26335--26335 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [435] [436] [437] Overfull \hbox (0.37231pt too wide) in paragraph at lines 26423--26423 \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 26423--26423 \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 26423--26423 \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 26423--26423 \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 26423--26423 [][]\T1/cmtt/m/n/10 An error will result if the supplied string contains any ca rds which cannot be [438] Overfull \hbox (47.34834pt too wide) in paragraph at lines 26467--26467 \T1/cmtt/m/n/10 A pointer to be made available to the source and sink functions via the astChannelData [439] Overfull \hbox (15.8076pt too wide) in paragraph at lines 26525--26525 []\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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \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 26525--26525 \T1/cmtt/m/n/10 elements of each value should be stored in " Fortran" order. No data type conversion [440] Overfull \hbox (10.86975pt too wide) in paragraph at lines 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 \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 26578--26578 [][]\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 26578--26578 \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 26578--26578 [][]\T1/cmtt/m/n/10 An error will result if the supplied string cannot be inter preted as a FITS header [441] Overfull \hbox (52.8595pt too wide) in paragraph at lines 26632--26632 \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 26632--26632 \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 26632--26632 \T1/cmtt/m/n/10 A deep copy of the FitsTable is stored in the FitsChan, so any subsequent changes [442] Overfull \hbox (16.11847pt too wide) in paragraph at lines 26678--26678 \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 26678--26678 \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 26678--26678 \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 26678--26678 [][]\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 26678--26678 [][]\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 26678--26678 \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 26678--26678 \T1/cmtt/m/n/10 , " BITPIX" , " NAXIS" , " NAXIS1" , " NAXIS2" , " PCOUNT" , " GCOUNT" , " TFIELDS" [443] Overfull \hbox (26.6159pt too wide) in paragraph at lines 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 \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 26736--26736 [][]\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 26736--26736 [][]\T1/cmtt/m/n/10 The []astPutTable[] method provides a simpler means of addi ng a single table to a [444] Overfull \hbox (15.85886pt too wide) in paragraph at lines 26851--26851 []\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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 \T1/cmtt/m/n/10 Pointer to an array of doubles containing the upper bounds of t he box specifying Overfull \hbox (0.37231pt too wide) in paragraph at lines 26851--26851 [] \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 26851--26851 \T1/cmtt/m/n/10 is at " lbnd[0]" and the last is at " ubnd[0]" . If a value les s than three is Overfull \hbox (5.62103pt too wide) in paragraph at lines 26851--26851 [] \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 26851--26851 \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 26851--26851 [] \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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 []\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 26851--26851 \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 26851--26851 \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 26851--26851 \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 26851--26851 [][]\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 26851--26851 \T1/cmtt/m/n/10 transformation, the Mapping should be inverted using []astInver t[] before invoking [445] Overfull \hbox (26.35347pt too wide) in paragraph at lines 26851--26851 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the global error [446] Overfull \hbox (21.36719pt too wide) in paragraph at lines 26920--26920 [] \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 26920--26920 \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 26920--26920 \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 26920--26920 \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 26920--26920 \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 26920--26920 [][]\T1/cmtt/m/n/10 A value of AST__BAD will be returned if this function is in voked with the global [447] Overfull \hbox (4.4716pt too wide) in paragraph at lines 27020--27020 []\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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 \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 27020--27020 [] \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 27020--27020 \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 27020--27020 \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 27020--27020 [][]\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 27020--27020 \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 27020--27020 \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 27020--27020 \T1/cmtt/m/n/10 its component Mappings is required, then a copy of the RateMap should be made [448] Overfull \hbox (5.62103pt too wide) in paragraph at lines 27020--27020 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [449] Overfull \hbox (18.0096pt too wide) in paragraph at lines 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 \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 27088--27088 [][]\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 27088--27088 [][]\T1/cmtt/m/n/10 A null Object pointer will also be returned if this functio n is invoked with the [450] Overfull \hbox (0.37231pt too wide) in paragraph at lines 27130--27130 [][]\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 27130--27130 [][]\T1/cmtt/m/n/10 The []SourceFile[] attribute is ignored by this function. N ew cards are read from [451] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 27653. Overfull \hbox (6.0526pt too wide) in paragraph at lines 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 > $ [452] Overfull \hbox (16.11847pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 [] \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\T1/cmtt/m/n/10 If no additional parameters are required, this array is not u sed and a NULL pointer [453] Overfull \hbox (5.3586pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 27653--27653 [] \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 Pointer to an array of integers, with " ndim_out" elements, con taining the coordinates [454] Overfull \hbox (47.61078pt too wide) in paragraph at lines 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 For example, astRebinD would be used to process " double" data, while astRebinI would [455] Overfull \hbox (41.17413pt too wide) in paragraph at lines 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 [][]\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \T1/cmtt/m/n/10 additional control over the rebinning process. Having selected a set of flags, you [456] Overfull \hbox (10.86975pt too wide) in paragraph at lines 27653--27653 [][]\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 []\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 27653--27653 \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 27653--27653 []\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 27653--27653 []\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 27653--27653 []\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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \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 27653--27653 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [457] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 28255. Overfull \hbox (21.79875pt too wide) in paragraph at lines 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 value is returned set to the supplied bad value. If the supplie d value is less [458] Overfull \hbox (5.3586pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [] \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a [459] Overfull \hbox (16.11847pt too wide) in paragraph at lines 28255--28255 [] \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \T1/cmtt/m/n/10 system of the output grid in the same way as " lbnd_in" and " u bnd_in" define [460] Overfull \hbox (42.36206pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 \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 [461] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 by a factor equal to the number of input samples that contribut e to the output [462] Overfull \hbox (10.86975pt too wide) in paragraph at lines 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 [][]\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 []\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 28255--28255 []\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 28255--28255 []\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 28255--28255 \T1/cmtt/m/n/10 of the " badval" value in the " out" array. These are only prod uced if the AST__REBINEND [463] Overfull \hbox (7.51216pt too wide) in paragraph at lines 28255--28255 []\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 28255--28255 []\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 28255--28255 []\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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \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 28255--28255 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [464] [465] Overfull \hbox (0.10988pt too wide) in paragraph at lines 28358--28358 \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 28358--28358 \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 28358--28358 \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 28358--28358 \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 28358--28358 [][]\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 28358--28358 [][]\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 28358--28358 \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 28358--28358 [][]\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 28358--28358 \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 28358--28358 [][]\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 28358--28358 \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 28358--28358 [][]\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 28358--28358 \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 28358--28358 [][]\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 28358--28358 \T1/cmtt/m/n/10 variant) will be lost as a consequence of calling this method ( see attribute " [466] Overfull \hbox (17.43065pt too wide) in paragraph at lines 28387--28387 \T1/cmtt/m/n/10 The column name. Trailing spaces are ignored (all other spaces are significant). [467] Overfull \hbox (15.85603pt too wide) in paragraph at lines 28446--28446 \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 28446--28446 \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 28446--28446 [][]\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 28446--28446 \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 28446--28446 [][]\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 28446--28446 [][]\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 28446--28446 [][]\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 28446--28446 \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 28446--28446 [][]\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 28446--28446 \T1/cmtt/m/n/10 To ensure this, the Base and/or Current attributes of the Frame Set will be changed, [468] Overfull \hbox (33.1768pt too wide) in paragraph at lines 28475--28475 \T1/cmtt/m/n/10 The parameter name. Trailing spaces are ignored (all other spac es are significant). [469] Overfull \hbox (18.27203pt too wide) in paragraph at lines 28558--28558 \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 28558--28558 \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 28558--28558 \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 28558--28558 \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 28558--28558 \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 28558--28558 [][]\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 28558--28558 \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 28558--28558 [][]\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 28558--28558 \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 28558--28558 \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 28558--28558 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [470] [471] Overfull \hbox (21.10475pt too wide) in paragraph at lines 28614--28614 \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 28614--28614 \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 28614--28614 [472] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29462. Overfull \hbox (3.69067pt too wide) in paragraph at lines 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 int ndim_out, const int lbnd_out[], const int ubnd_out[], const int lbnd[], const int [473] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [] \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 have (several are possible, depending on the value of " interp" ), see the " Sub-Pixel [474] Overfull \hbox (52.8595pt too wide) in paragraph at lines 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 for a description of the options available. If no flag values a re to be set, a Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 [] \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 which no resampled value could be obtained are left set to the value they had [475] Overfull \hbox (5.3586pt too wide) in paragraph at lines 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 output pixels received valid resampled data values (and varianc es). See the " badval" [476] Overfull \hbox (26.35347pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 a good cosmetic result, so is useful for quick-look processing, but is unsuitable [477] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 as implemented by other kernels, is generally to be preferred. This kernel is [478] Overfull \hbox (56.1174pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 In addition, the following schemes are provided which are not b ased on a 1-dimensional [479] Overfull \hbox (21.36719pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 literally and the " badval" value is only used for flagging out put array values. [480] Overfull \hbox (0.37231pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 []\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 an input variance estimate may be regarded as bad either becaus e it has the value [481] Overfull \hbox (26.6159pt too wide) in paragraph at lines 29462--29462 [][]\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 29462--29462 \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 29462--29462 [][]\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 []\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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \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 29462--29462 \T1/cmtt/m/n/10 The function name is changed by inserting the digit " 8" before the trailing data type [482] Overfull \hbox (12.97206pt too wide) in paragraph at lines 29544--29544 []\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 29544--29544 \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 29544--29544 \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 29544--29544 \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 29544--29544 \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 29544--29544 \T1/cmtt/m/n/10 of the point of closest approach of the basis vector to point 3 will be returned. Overfull \hbox (10.86975pt too wide) in paragraph at lines 29544--29544 [] \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 29544--29544 \T1/cmtt/m/n/10 4 (that is, the length of the component parallel to the basis v ector). Positive Overfull \hbox (10.86975pt too wide) in paragraph at lines 29544--29544 [] \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 29544--29544 \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 29544--29544 [][]\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 29544--29544 [][]\T1/cmtt/m/n/10 This function will return " bad" coordinate values (AST__BA D) if any of the input [483] Overfull \hbox (10.86975pt too wide) in paragraph at lines 29585--29585 [][]\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 29585--29585 \T1/cmtt/m/n/10 the " end-of-file" (i.e. if the []Card[] attribute exceeds the number of cards in [484] Overfull \hbox (16.11847pt too wide) in paragraph at lines 29636--29636 [][]\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 29636--29636 [][]\T1/cmtt/m/n/10 A value of zero will be returned if this function is invoke d with the AST error [485] Overfull \hbox (23.41824pt too wide) in paragraph at lines 29737--29737 []\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 29737--29737 \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 29737--29737 \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 29737--29737 \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 29737--29737 \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 29737--29737 \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 29737--29737 \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 29737--29737 [] \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 29737--29737 \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 29737--29737 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [486] Overfull \hbox (5.62103pt too wide) in paragraph at lines 29737--29737 [][]\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 29737--29737 \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 29737--29737 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [487] Overfull \hbox (10.86975pt too wide) in paragraph at lines 29843--29843 \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 29843--29843 [] \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 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 29843--29843 Underfull \hbox (badness 10000) in paragraph at lines 29843--29843 [] \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 29843--29843 [][]\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 29843--29843 \T1/cmtt/m/n/10 (except for string-valued attributes where it is significant an d forms part of [488] Overfull \hbox (42.36206pt too wide) in paragraph at lines 29843--29843 [][]\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 29843--29843 \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 29843--29843 \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 29843--29843 [][]\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 29843--29843 \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 29843--29843 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [489] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 29915. Overfull \hbox (26.6159pt too wide) in paragraph at lines 29915--29915 \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 29915--29915 \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 29915--29915 \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 29915--29915 Underfull \hbox (badness 10000) in paragraph at lines 29915--29915 Underfull \hbox (badness 10000) in paragraph at lines 29915--29915 [] \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 29915--29915 [][]\T1/cmtt/m/n/10 An error will result if an attempt is made to set a value f or a read-only attribute. [490] Overfull \hbox (23.25832pt too wide) in paragraph at lines 30041--30041 \T1/cmtt/m/n/10 The ActiveUnit flag for a SkyFrame is always 0 (any value suppl ied using this function [491] Overfull \hbox (28.50703pt too wide) in paragraph at lines 30041--30041 \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 30041--30041 \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 30041--30041 \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 30041--30041 \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 30041--30041 \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 30041--30041 \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 30041--30041 [][]\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 30041--30041 \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 30041--30041 [][]\T1/cmtt/m/n/10 The []astGetActiveUnit[] function can be used to retrieve t he current value of the [492] Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding): (hyperref) removing `math shift' on input line 30191. Overfull \hbox (14.82803pt too wide) in paragraph at lines 30191--30191 []\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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \T1/cmtt/m/n/10 contains no comment, then any existing comment in the card bein g over-written [493] Overfull \hbox (26.6159pt too wide) in paragraph at lines 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 \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 30191--30191 [][]\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 30191--30191 [][]\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 30191--30191 [][]\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 30191--30191 \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 30191--30191 [][]\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 30191--30191 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [494] Overfull \hbox (10.60732pt too wide) in paragraph at lines 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 \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 30245--30245 [][]\T1/cmtt/m/n/10 If, on exit, there are no cards following the card written by this function, then [495] Overfull \hbox (39.63802pt too wide) in paragraph at lines 30317--30317 []\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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 \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 30317--30317 [][]\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 30317--30317 [][]\T1/cmtt/m/n/10 An error will be reported if the keyword name does not conf orm to FITS requirements. [496] Overfull \hbox (5.3586pt too wide) in paragraph at lines 30369--30369 \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 30369--30369 \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 30369--30369 \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 30369--30369 []\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 30369--30369 \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 30369--30369 [][]\T1/cmtt/m/n/10 message - Pointer to a null-terminated character string con taining the error message [497] Overfull \hbox (5.62103pt too wide) in paragraph at lines 30413--30413 \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 30413--30413 \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 30413--30413 \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 30413--30413 \T1/cmtt/m/n/10 The longitude of the reference point, in the coordinate system represented by the Overfull \hbox (16.11847pt too wide) in paragraph at lines 30413--30413 [] \T1/cmtt/m/n/10 The latitude of the reference point, in the coordinate sy stem represented by the [498] Overfull \hbox (0.37231pt too wide) in paragraph at lines 30451--30451 [][]\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 30451--30451 \T1/cmtt/m/n/10 execute and will simply return without action. To clear the err or status and [499] Overfull \hbox (0.37231pt too wide) in paragraph at lines 30493--30493 \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 30493--30493 \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 30493--30493 \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 30493--30493 \T1/cmtt/m/n/10 will be taken, so subsequent changes to the uncertainty Region using the supplied [500] Overfull \hbox (9.50914pt too wide) in paragraph at lines 30570--30570 []\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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 \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 30570--30570 [] \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 30570--30570 \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 30570--30570 \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 30570--30570 [][]\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 30570--30570 []\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 30570--30570 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [501] [502] [503] Overfull \hbox (42.09962pt too wide) in paragraph at lines 30658--30658 \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 30658--30658 \T1/cmtt/m/n/10 to the Format attribute associated with the Frame' s axis. Othe rwise, they are [504] Overfull \hbox (44.51563pt too wide) in paragraph at lines 30741--30741 \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 30741--30741 [][]\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 30741--30741 \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 30741--30741 [][]\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 30741--30741 \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 30741--30741 [][]\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 30741--30741 \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 30741--30741 \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 30741--30741 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [505] Overfull \hbox (10.86975pt too wide) in paragraph at lines 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 [] \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 30870--30870 \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 30870--30870 \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 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \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 30870--30870 \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 30870--30870 \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 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \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 30870--30870 \T1/cmtt/m/n/10 default Epoch value (B1950.0) is used, but the mean Equinox val ue is given [506] Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 [] \T1/cmtt/m/n/10 Creates a SkyFrame to describe the Geocentric Apparent celes tial coordinate Underfull \hbox (badness 10000) in paragraph at lines 30870--30870 \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 30870--30870 [][]\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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 [][]\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 30870--30870 \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 30870--30870 [][]\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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 \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 30870--30870 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [507] Overfull \hbox (5.62103pt too wide) in paragraph at lines 30913--30913 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [508] Overfull \hbox (0.37231pt too wide) in paragraph at lines 31133--31133 [] \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 \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 31133--31133 [][]\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\T1/cmtt/m/n/10 This function does not check to ensure that the sequence of coordinate conversions [509] Overfull \hbox (49.23947pt too wide) in paragraph at lines 31133--31133 []\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 []\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 31133--31133 \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 31133--31133 \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 31133--31133 \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 31133--31133 [][]\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 31133--31133 [][]\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 31133--31133 [][]\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 31133--31133 [][]\T1/cmtt/m/n/10 " EQHPR" (DATE,OBSX,OBSY,OBSZ): Convert J2000.0 equatorial coordinates to Helioprojective-Radial. [510] Overfull \hbox (28.76947pt too wide) in paragraph at lines 31133--31133 \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 31133--31133 \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 31133--31133 \T1/cmtt/m/n/10 Thus, the effects of diurnal aberration are taken into account in the conversions but [511] Overfull \hbox (10.60732pt too wide) in paragraph at lines 31213--31213 \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 31213--31213 \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 31213--31213 \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 31213--31213 \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 31213--31213 \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 31213--31213 [] \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 31213--31213 \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 31213--31213 \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 31213--31213 [][]\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 31213--31213 \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 31213--31213 \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 31213--31213 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [512] Overfull \hbox (6.88478pt too wide) in paragraph at lines 31494--31494 []\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 31494--31494 [] \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 Overfull \hbox (37.11334pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 [][]\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 31494--31494 []\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 31494--31494 \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 31494--31494 \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 31494--31494 \T1/cmtt/m/n/10 these arguments should be given, via the " args" array, in the order indicated. Units [513] Overfull \hbox (5.62103pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\T1/cmtt/m/n/10 " HLF2LG" (RA,DEC): Convert frequency from heliocentric ref erence frame to local [514] Overfull \hbox (33.43924pt too wide) in paragraph at lines 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 [][]\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 31494--31494 \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 31494--31494 \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 31494--31494 \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 31494--31494 \T1/cmtt/m/n/10 " user-defined" reference frame used by USF2HL and HLF2US. Howe ver, AST__BAD can be [515] Overfull \hbox (18.64314pt too wide) in paragraph at lines 31579--31579 []\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 31579--31579 \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 31579--31579 \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 31579--31579 \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 31579--31579 \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 31579--31579 \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 31579--31579 \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 31579--31579 [] \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 31579--31579 \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 31579--31579 \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 31579--31579 [][]\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 31579--31579 \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 31579--31579 \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 31579--31579 [][]\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 31579--31579 []\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 31579--31579 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [516] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 [] \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 31679--31679 \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 31679--31679 \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 31679--31679 Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 [] \T1/cmtt/m/n/10 Creates a SpecFrame to describe the default wavelength spect ral coordinate Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 [] \T1/cmtt/m/n/10 Creates a SpecFrame describing a apparent radial velocity (" VELO" ) axis with Underfull \hbox (badness 10000) in paragraph at lines 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \T1/cmtt/m/n/10 SpecFrame with other SpecFrames which are also measured in the LSRK standard [517] Overfull \hbox (21.36719pt too wide) in paragraph at lines 31679--31679 [][]\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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 \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 31679--31679 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [518] Overfull \hbox (17.43065pt too wide) in paragraph at lines 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 [] \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 31795--31795 \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 31795--31795 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [519] Overfull \hbox (12.44437pt too wide) in paragraph at lines 31795--31795 [][]\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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 \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 31795--31795 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [520] Overfull \hbox (10.86975pt too wide) in paragraph at lines 31893--31893 \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 31893--31893 \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 31893--31893 \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 31893--31893 [] \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 31893--31893 \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 31893--31893 \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 31893--31893 [][]\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 31893--31893 \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 31893--31893 \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 31893--31893 [][]\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 31893--31893 [][]\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 31893--31893 []\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 31893--31893 \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 31893--31893 []\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 31893--31893 \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 31893--31893 []\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 31893--31893 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [521] [522] Overfull \hbox (42.36206pt too wide) in paragraph at lines 31922--31922 [][]\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 31922--31922 \T1/cmtt/m/n/10 will not execute and will simply return without action. To clea r the error status [523] Overfull \hbox (26.30504pt too wide) in paragraph at lines 32012--32012 []\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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 \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 32012--32012 [] \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 32012--32012 \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 32012--32012 \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 32012--32012 [][]\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 32012--32012 \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 32012--32012 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [524] [525] Overfull \hbox (28.9294pt too wide) in paragraph at lines 32102--32102 []\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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 \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 32102--32102 [] \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 32102--32102 \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 32102--32102 \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 32102--32102 [][]\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 32102--32102 \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 32102--32102 [][]\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 32200--32200 []\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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 \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 32200--32200 [] \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 32200--32200 \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 32200--32200 \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 32200--32200 [][]\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 32200--32200 \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 32200--32200 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [528] Overfull \hbox (2.26344pt too wide) in paragraph at lines 32200--32200 []\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 32200--32200 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [529] Overfull \hbox (23.68068pt too wide) in paragraph at lines 32298--32298 []\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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 \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 32298--32298 [] \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 32298--32298 \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 32298--32298 \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 32298--32298 [][]\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 32298--32298 \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 32298--32298 [][]\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 32298--32298 []\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 32298--32298 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [531] Overfull \hbox (8.09445pt too wide) in paragraph at lines 32401--32401 []\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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 []\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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 []\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 32401--32401 \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 32401--32401 \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 32401--32401 \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 32401--32401 [] \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 32401--32401 \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 32401--32401 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [532] Overfull \hbox (8.24539pt too wide) in paragraph at lines 32401--32401 [][]\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 32401--32401 \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 32401--32401 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [533] Overfull \hbox (2.52588pt too wide) in paragraph at lines 32442--32442 \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 32442--32442 \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 32442--32442 \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 32442--32442 \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 32442--32442 \T1/cmtt/m/n/10 indicating that escape sequences should not be stripped, then t he supplied string is [534] Overfull \hbox (34.3893pt too wide) in paragraph at lines 32601--32601 []\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 [535] Overfull \hbox (65.9813pt too wide) in paragraph at lines 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 [] \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 32601--32601 \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 32601--32601 \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 32601--32601 [][]\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 32601--32601 \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 32601--32601 \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 32601--32601 \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 32601--32601 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [536] Overfull \hbox (10.86975pt too wide) in paragraph at lines 32691--32691 \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 32691--32691 \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 32691--32691 \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 32691--32691 [] \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 32691--32691 \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 32691--32691 \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 32691--32691 [][]\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 32691--32691 []\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 32691--32691 \T1/cmtt/m/n/10 the parameter list described above. This parameter is a pointer to the integer inherited [537] Overfull \hbox (18.3807pt too wide) in paragraph at lines 32771--32771 []\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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 []\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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 \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 32771--32771 []\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 32771--32771 [][]\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 32771--32771 \T1/cmtt/m/n/10 table source function using the []astPutChannelData[] function. The source function [538] Overfull \hbox (26.6159pt too wide) in paragraph at lines 32829--32829 \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 32829--32829 \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 32829--32829 [][]\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 32829--32829 [][]\T1/cmtt/m/n/10 A value of zero will also be returned if this function is u sed to test a read-only [539] Overfull \hbox (10.60732pt too wide) in paragraph at lines 32880--32880 \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 32880--32880 \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 32880--32880 \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 32880--32880 \T1/cmtt/m/n/10 One if the specified cell is included in the Moc at the specifi ed order, of (if " parent" [540] Overfull \hbox (7.19565pt too wide) in paragraph at lines 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 [][]\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 32960--32960 \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 32960--32960 \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 32960--32960 \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 32960--32960 [][]\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 32960--32960 [][]\T1/cmtt/m/n/10 Zero is returned as the function value if an error has alre ady occurred, or if [541] Overfull \hbox (10.55888pt too wide) in paragraph at lines 33049--33049 []\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 33049--33049 \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 33049--33049 \T1/cmtt/m/n/10 An array, with one element for each axis of the Plot, giving th e physical coordinates Overfull \hbox (5.62103pt too wide) in paragraph at lines 33049--33049 [] \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 \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 33049--33049 []\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 33049--33049 [][]\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 33049--33049 [][]\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 33049--33049 \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 33049--33049 [][]\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 33049--33049 [][]\T1/cmtt/m/n/10 An error also results if the transformation between the cur rent and base Frames [542] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33143--33143 [] \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 [][]\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 33143--33143 \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 33143--33143 [][]\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 33143--33143 \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 33143--33143 []\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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 []\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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 \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 33143--33143 []\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 33143--33143 \T1/cmtt/m/n/10 currently owned by the running thread (at the current context l evel) are annulled. This [543] Overfull \hbox (28.76947pt too wide) in paragraph at lines 33143--33143 []\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 33143--33143 \T1/cmtt/m/n/10 itself. If " ptr" is non-zero, then the returned value describe s the supplied Object [544] Overfull \hbox (6.88478pt too wide) in paragraph at lines 33383--33383 []\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 33383--33383 [] \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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 [][]\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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 [][]\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 33383--33383 []\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 33383--33383 \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 33383--33383 \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 33383--33383 \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 33383--33383 \T1/cmtt/m/n/10 and argument names are described at the end of the list of conv ersions, and " MJD" [545] Overfull \hbox (33.75575pt too wide) in paragraph at lines 33383--33383 \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 33383--33383 \T1/cmtt/m/n/10 function. The axis values supplied and returned by astTransform are offsets away from [546] Overfull \hbox (43.93668pt too wide) in paragraph at lines 33383--33383 [][]\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 33383--33383 [][]\T1/cmtt/m/n/10 LTOFF: The offset between Local Time and UTC (in hours, pos itive for time zones [547] Overfull \hbox (10.86975pt too wide) in paragraph at lines 33473--33473 \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 33473--33473 \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 33473--33473 \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 33473--33473 \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 33473--33473 [] \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 33473--33473 \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 33473--33473 \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 33473--33473 [][]\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 33473--33473 \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 33473--33473 \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 33473--33473 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [548] [549] Overfull \hbox (10.60732pt too wide) in paragraph at lines 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 [] \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 33555--33555 \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 33555--33555 \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 33555--33555 [][]\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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 \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 33555--33555 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [550] Overfull \hbox (23.25832pt too wide) in paragraph at lines 33585--33585 \T1/cmtt/m/n/10 Pointer to dynamically allocated memory holding the serialisati on, or NULL if an error [551] Overfull \hbox (12.97206pt too wide) in paragraph at lines 33653--33653 []\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 33653--33653 \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 33653--33653 \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 33653--33653 \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 33653--33653 [][]\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 33653--33653 []\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 33653--33653 \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 33653--33653 \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 33653--33653 \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 33653--33653 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [552] Overfull \hbox (10.3477pt too wide) in paragraph at lines 33734--33734 []\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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 [][]\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 33734--33734 []\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 33734--33734 \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 33734--33734 \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 33734--33734 \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 33734--33734 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [553] Overfull \hbox (20.84514pt too wide) in paragraph at lines 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \T1/cmtt/m/n/10 coordinate system, each pixel having unit extent along each dim ension with integral Overfull \hbox (16.11847pt too wide) in paragraph at lines 33906--33906 [] \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \T1/cmtt/m/n/10 whose size does not exceed " maxpix" grid points in any dimensi on. Only at this [554] Overfull \hbox (42.09962pt too wide) in paragraph at lines 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 [][]\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 33906--33906 \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 33906--33906 \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 33906--33906 []\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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \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 33906--33906 \T1/cmtt/m/n/10 name is changed by appending the digit " 8" to the name. Thus, astTranGrid becomes [555] Overfull \hbox (9.9315pt too wide) in paragraph at lines 34008--34008 []\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 34008--34008 \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 34008--34008 \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 34008--34008 \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 34008--34008 \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 34008--34008 \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 34008--34008 [] \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 34008--34008 \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 34008--34008 \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 34008--34008 [][]\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 34008--34008 \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 34008--34008 [][]\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 34008--34008 \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 34008--34008 \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 34008--34008 \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 34008--34008 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [556] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34008--34008 []\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 34008--34008 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [557] Overfull \hbox (7.72334pt too wide) in paragraph at lines 34128--34128 []\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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \T1/cmtt/m/n/10 can be correctly located if they do not entirely fill this arra y. The value given Overfull \hbox (58.10822pt too wide) in paragraph at lines 34128--34128 [] \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \T1/cmtt/m/n/10 These will be stored such that the value of coordinate number " coord" for output [558] Overfull \hbox (10.86975pt too wide) in paragraph at lines 34128--34128 [][]\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 34128--34128 \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 34128--34128 \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 34128--34128 []\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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 \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 34128--34128 [559] Overfull \hbox (5.31017pt too wide) in paragraph at lines 34234--34234 []\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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 [][]\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 34234--34234 \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 34234--34234 \T1/cmtt/m/n/10 for its []Nout[] attribute. If the inverse transformation is be ing applied, these [560] Overfull \hbox (49.76434pt too wide) in paragraph at lines 34234--34234 []\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 34234--34234 \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 34234--34234 \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 34234--34234 \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 34234--34234 \T1/cmtt/m/n/10 (defined in header file stdint.h). The function name is changed by appending the digit [561] Overfull \hbox (0.10988pt too wide) in paragraph at lines 34316--34316 \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 34316--34316 \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 34316--34316 [][]\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 34316--34316 \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 34316--34316 Overfull \hbox (2.001pt too wide) in paragraph at lines 34316--34316 \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 34316--34316 []\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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \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 34316--34316 \T1/cmtt/m/n/10 blocks of less than 300 bytes allocated by AST (whether for int ernal or external use), [562] Overfull \hbox (5.3586pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 [][]\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 34429--34429 \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 34429--34429 Overfull \hbox (7.51216pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 [563] Overfull \hbox (2.26344pt too wide) in paragraph at lines 34429--34429 \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 34429--34429 \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 34429--34429 \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 34429--34429 \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 [564] Overfull \hbox (7.51216pt too wide) in paragraph at lines 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 [] \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 " point" is therefore given by " coords[coord][point]" (assumin g both indices [565] Overfull \hbox (21.36719pt too wide) in paragraph at lines 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 []\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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 be returned is " npoint" , and the minimum is zero (indicating that all output [566] Overfull \hbox (14.44772pt too wide) in paragraph at lines 34637--34637 [][]\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 34637--34637 [][]\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 34637--34637 [][]\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 34637--34637 \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 34637--34637 \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 34637--34637 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [567] Overfull \hbox (5.3586pt too wide) in paragraph at lines 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 [][]\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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 \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 34728--34728 [][]\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 34728--34728 \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 34728--34728 \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 34728--34728 \T1/cmtt/m/n/10 other values may also be used (e.g. if you wish to distinguish different types [568] [569] Overfull \hbox (0.10988pt too wide) in paragraph at lines 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \T1/cmtt/m/n/10 1.5. It is therefore most important to check the return value o f this function [570] Overfull \hbox (18.74283pt too wide) in paragraph at lines 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \T1/cmtt/m/n/10 used. Fields must be given in order of decreasing significance (e.g. " -11D [571] Overfull \hbox (10.86975pt too wide) in paragraph at lines 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 [][]\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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 \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 35026--35026 []\T1/cmtt/m/n/10 Examples of acceptable SkyFrame input formats (with interpret ation in parentheses) [572] Overfull \hbox (7.51216pt too wide) in paragraph at lines 35026--35026 \T1/cmtt/m/n/10 Where alternative interpretations are shown, the choice of angl e or time depends on [573] Overfull \hbox (0.10988pt too wide) in paragraph at lines 35087--35087 \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 35087--35087 \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 35087--35087 \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 35087--35087 \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 35087--35087 [] \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 35087--35087 \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 35087--35087 \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 35087--35087 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [574] Overfull \hbox (26.30504pt too wide) in paragraph at lines 35190--35190 []\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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 \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 35190--35190 [] \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 35190--35190 \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 35190--35190 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [575] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35190--35190 [][]\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 35190--35190 []\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 35190--35190 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [576] Overfull \hbox (47.61078pt too wide) in paragraph at lines 35252--35252 \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 35252--35252 \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 35252--35252 [][]\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 35252--35252 \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 35252--35252 [][]\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 35252--35252 [][]\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 35252--35252 \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 35252--35252 [][]\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 35252--35252 \T1/cmtt/m/n/10 POSIX thread support (i.e. the " -with-pthreads" option was not specified when [577] Overfull \hbox (12.76088pt too wide) in paragraph at lines 35287--35287 \T1/cmtt/m/n/10 The major version, minor version and release numbers for the AS T library, encoded as [578] Overfull \hbox (44.25319pt too wide) in paragraph at lines 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 []\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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \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 35389--35389 \T1/cmtt/m/n/10 A pointer to the KeyMap holding the warning messages, or NULL i f no warnings were issued [579] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35389--35389 [][]\T1/cmtt/m/n/10 A value of NULL will be returned if this function is invoke d with the AST error [580] Overfull \hbox (0.37231pt too wide) in paragraph at lines 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 \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 35442--35442 [][]\T1/cmtt/m/n/10 This function is not available in the FORTRAN 77 interface to the AST library. [581] Overfull \hbox (21.05632pt too wide) in paragraph at lines 35626--35626 []\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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 The index of the longitude axis. This should lie in the range 1 to " ncoord" [582] Overfull \hbox (15.85603pt too wide) in paragraph at lines 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 []\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 35626--35626 \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 35626--35626 \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 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 35626--35626 Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 35626--35626 Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 [] \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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 copied unchanged. []Projection[] parameter 1 associatyed with t he latitude axis Underfull \hbox (badness 10000) in paragraph at lines 35626--35626 \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 35626--35626 \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 35626--35626 \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 35626--35626 [][]\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 35626--35626 \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 35626--35626 \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 35626--35626 [][]\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 35626--35626 \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 35626--35626 [][]\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 35626--35626 \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 35626--35626 \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 35626--35626 \T1/cmtt/m/n/10 will result if the projection parameters do not satisfy all the required constraints [583] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35626--35626 [][]\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 35626--35626 []\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 35626--35626 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [584] Overfull \hbox (23.4695pt too wide) in paragraph at lines 35732--35732 []\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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 \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 35732--35732 [] \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 35732--35732 \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 35732--35732 \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 35732--35732 [][]\T1/cmtt/m/n/10 A null []Object[] pointer (AST__NULL) will be returned if t his function is invoked [585] Overfull \hbox (2.26344pt too wide) in paragraph at lines 35732--35732 []\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 35732--35732 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [586] Overfull \hbox (7.51216pt too wide) in paragraph at lines 35795--35795 \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 35795--35795 \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 35795--35795 \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 35795--35795 [][]\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 35795--35795 [][]\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 35795--35795 \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 35795--35795 \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 35795--35795 \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 35795--35795 \T1/cmtt/m/n/10 to an internal buffer (the sink function is not invoked). This buffer is written [587] Overfull \hbox (10.60732pt too wide) in paragraph at lines 35832--35832 [][]\T1/cmtt/m/n/10 If the SinkFile is unset, and no sink function is available , this method simply [588] Overfull \hbox (8.56807pt too wide) in paragraph at lines 35933--35933 []\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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 []\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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 []\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 35933--35933 \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 35933--35933 \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 35933--35933 \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 35933--35933 [] \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 35933--35933 \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 35933--35933 \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 35933--35933 [][]\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 35933--35933 \T1/cmtt/m/n/10 the supplied source and sink functions should translate between the external character [589] Overfull \hbox (5.62103pt too wide) in paragraph at lines 35933--35933 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [590] Overfull \hbox (8.09445pt too wide) in paragraph at lines 36036--36036 []\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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 []\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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 []\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 36036--36036 \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 36036--36036 \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 36036--36036 \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 36036--36036 [] \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 36036--36036 \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 36036--36036 \T1/cmtt/m/n/10 for these specifiers. The rules for supplying these are identic al to those for [591] Overfull \hbox (8.24539pt too wide) in paragraph at lines 36036--36036 [][]\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 36036--36036 \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 36036--36036 [][]\T1/cmtt/m/n/10 A null Object pointer (AST__NULL) will be returned if this function is invoked [592] Overfull \hbox (26.09103pt too wide) in paragraph at lines 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 \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 36117--36117 [] \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 36117--36117 \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 36117--36117 \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 36117--36117 [][]\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 36117--36117 []\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 36117--36117 \T1/cmtt/m/n/10 the parameter list descirbed above. This parameter is a pointer to the integer inherited [593] [594] [595] [596] [597] [598] [599] [600] [601] [602] [603] [604] [605] [606] [607] [608] [609] [610] [611] [612] [613] [614] [615] [616] Overfull \hbox (37.49187pt too wide) in paragraph at lines 37043--37043 \T1/ppl/m/n/10 (-20) AST__FLOAT, AST__STRING, AST__COMPLEXF, AST__COMPLEXI, AST __LOGICAL, AST__CONTINUE, [617] [618] [619] [620] [621] [622] [623] [624] [625] [626] [627] [628] [629] [630] [631] [632] [633] [634] [635] [636] [637] [638] [639] [640] [641] [642] [643] [644] [645] [646] [647] [648] [649] [650] [651] [652] [653] [654] [655] [656] [657] [658] [659] [660] [661] [662] [663] [664] [665] [666] [667] [668] [669] [670] [671] [672] [673] [674] [675] [676] [677] [678] [679] [680] [681] [682] [683] [684] [685] [686] [687] [688] [689] [690] [691] [692] [693] [694] [695] [696] [697] [698] [699] [700] [701] [702] [703] [704] [705] [706] [707] [708] [709] [710] [711] [712] [713] [714] [715] [716] [717] [718] [719] [720] [721] [722] [723] [724] [725] [726] [727] [728] [729] [730] [731] [732] [733] [734] [735] [736] [737] [738] [739] [740] [741] [742] [743] [744] [745] [746] [747] Overfull \hbox (59.49594pt too wide) in paragraph at lines 42702--42702 \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)=- [748] [749] [750] [751] [752] Underfull \hbox (badness 10000) in paragraph at lines 42886--42886 [753] [754] [755] [756] [757] [758] [759] [760] [761] [762] [763] [764] [765] [766] [767] [768] [769] Overfull \hbox (238.94087pt too wide) in paragraph at lines 43592--43592 \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 [770] Overfull \hbox (190.3857pt too wide) in paragraph at lines 43623--43623 \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 [771] [772] [773] [774] [775] [776] [777] [778] [779] [780] [781] [782] [783] [784] [785] [786] [787] [788] [789] [790] [791] [792] [793] [794] [795] [796] [797] [798] [799] [800] [801] [802] [803] Overfull \hbox (146.29462pt too wide) in paragraph at lines 45487--45487 \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. [804] [805] [806] [807] [808] [809] [810] [811] [812] [813] [814] [815] [816] [817] Underfull \hbox (badness 10000) in paragraph at lines 46120--46120 [818] [819] [820] [821] [822] [823] [824] [825] [826] [827] [828] [829] [830] [831] [832] [833] [834] [835] [836] [837] [838] [839] [840] [841] [842] [843] [844] [845] [846] [847] [848] [849] [850] [851] [852] [853] [854] [855] [856] [857] [858] [859] [860] [861] [862] [863] [864] [865] [866] [867] [868] [869] [870] [871] [872] [873] [874] [875] [876] [877] [878] [879] [880] [881] [882] [883] [884] [885] [886] [887] [888] [889] [890] [891] [892] [893] [894] [895] Overfull \hbox (7.12534pt too wide) in paragraph at lines 50650--50650 \T1/ppl/m/n/10 (-20) CAL_GROUP_CENTER, UN-KNOWN-Ref-Pos, EM-BARYCEN-TER, MOON, MER-CURY, VENUS, [896] [897] [898] [899] [900] [901] [902] [903] [904] [905] [906] [907] [908] [909] [910] [911] [912] [913] Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 Underfull \hbox (badness 10000) in paragraph at lines 51597--51597 [914] [915] Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 Underfull \hbox (badness 10000) in paragraph at lines 51762--51762 [916] [917] [918] [919] Overfull \hbox (5.62103pt too wide) in paragraph at lines 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 [] \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 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 []\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 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 \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 51884--51884 [][]\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 51884--51884 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [920] Overfull \hbox (5.62103pt too wide) in paragraph at lines 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 [] \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 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 []\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 51960--51960 \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 51960--51960 \T1/cmtt/m/n/10 to " str1" . It may contain format specifications such as used with the C " printf" Overfull \hbox (16.11847pt too wide) in paragraph at lines 51960--51960 [] \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 51960--51960 \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 51960--51960 Overfull \hbox (28.50703pt too wide) in paragraph at lines 51960--51960 \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 51960--51960 \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 51960--51960 \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 51960--51960 [][]\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 51960--51960 \T1/cmtt/m/n/10 for any reason, then the returned pointer will be equal to " st r1" and the dynamic [921] Overfull \hbox (21.10757pt too wide) in paragraph at lines 52081--52081 []\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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \T1/cmtt/m/n/10 bracket is the first character in the search. The returned poin ter should be Overfull \hbox (21.36719pt too wide) in paragraph at lines 52081--52081 [] \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 \T1/cmtt/m/n/10 bracket is the last character in the search. The returned point er should be freed [922] Overfull \hbox (7.51216pt too wide) in paragraph at lines 52081--52081 \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 52081--52081 \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 52081--52081 \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 52081--52081 [][]\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 52081--52081 [][]\T1/cmtt/m/n/10 If no bracketed sub-string is found, all the returned point ers will be NULL, " [923] Overfull \hbox (2.26344pt too wide) in paragraph at lines 52129--52129 \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 52129--52129 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [924] Overfull \hbox (21.10475pt too wide) in paragraph at lines 52165--52165 [][]\T1/cmtt/m/n/10 A value of AST__BAD is returned if this function is invoked with the global error [925] Overfull \hbox (42.36206pt too wide) in paragraph at lines 52209--52209 [] \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \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 52209--52209 \T1/cmtt/m/n/10 - 1" characters will be copied from " in" to " out" , and a ter minating null character [926] [927] Overfull \hbox (10.13652pt too wide) in paragraph at lines 52260--52260 \T1/cmtt/m/n/10 The number of characters in the supplied string, not including the trailing newline, [928] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52301--52301 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [929] Overfull \hbox (0.10988pt too wide) in paragraph at lines 52347--52347 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [930] [931] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52412--52412 \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 52412--52412 \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 52412--52412 \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 52412--52412 [][]\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 52412--52412 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [932] Overfull \hbox (7.72334pt too wide) in paragraph at lines 52466--52466 \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 52466--52466 \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 52466--52466 [][]\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 52466--52466 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [933] Overfull \hbox (35.49646pt too wide) in paragraph at lines 52540--52540 []\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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 [][]\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 52540--52540 \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 52540--52540 \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 52540--52540 \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 52540--52540 [][]\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 52540--52540 \T1/cmtt/m/n/10 set or if it should fail for any reason, or if the supplied str ing contains no [934] Overfull \hbox (13.86804pt too wide) in paragraph at lines 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 \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 52675--52675 [][]\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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \T1/cmtt/m/n/10 match the minimum length possible that still gives an overall m atch to the template). [935] Overfull \hbox (13.02332pt too wide) in paragraph at lines 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 []\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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 []\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 52675--52675 \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 52675--52675 \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 52675--52675 \T1/cmtt/m/n/10 by the part of the test string that matched the second parenthe sised sub-string in [936] [937] Overfull \hbox (1.84724pt too wide) in paragraph at lines 52751--52751 []\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 52751--52751 \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 52751--52751 \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 52751--52751 \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 52751--52751 [] \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 52751--52751 [] \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 52751--52751 [][]\T1/cmtt/m/n/10 " f" is returned greater than " l" if the specified section of the string is entirely [938] Overfull \hbox (10.86975pt too wide) in paragraph at lines 52782--52782 [] \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 52782--52782 \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 52782--52782 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [939] Overfull \hbox (10.86975pt too wide) in paragraph at lines 52820--52820 [] \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 52820--52820 \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 52820--52820 \T1/cmtt/m/n/10 NULL pointer value is accepted (without error) as indicating th at no memory has [940] Overfull \hbox (12.44437pt too wide) in paragraph at lines 52883--52883 [] \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 52883--52883 \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 52883--52883 [][]\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 52883--52883 \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 52883--52883 \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 52883--52883 [][]\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 52883--52883 \T1/cmtt/m/n/10 any reason, the original pointer value is returned and the memo ry contents are [941] Overfull \hbox (7.7746pt too wide) in paragraph at lines 52924--52924 \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 52924--52924 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [942] Overfull \hbox (2.26344pt too wide) in paragraph at lines 52965--52965 \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 52965--52965 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [943] Overfull \hbox (12.18193pt too wide) in paragraph at lines 53001--53001 \T1/cmtt/m/n/10 The new value for the MemoryCaching tuning parameter (see []ast Tune[] in objectc.c). [944] Overfull \hbox (42.36206pt too wide) in paragraph at lines 53058--53058 [] \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 53058--53058 \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 53058--53058 \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 53058--53058 \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 53058--53058 [][]\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 53058--53058 \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 53058--53058 \T1/cmtt/m/n/10 Note that this behaviour differs from that of the standard C " realloc" function [945] [946] Overfull \hbox (0.37231pt too wide) in paragraph at lines 53115--53115 [] \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 53115--53115 \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 53115--53115 [][]\T1/cmtt/m/n/10 A value of zero is returned if this function is invoked wit h the global error [947] Overfull \hbox (12.44437pt too wide) in paragraph at lines 53179--53179 [] \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 \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 53179--53179 [][]\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 53179--53179 \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 53179--53179 \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 53179--53179 [][]\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 53179--53179 \T1/cmtt/m/n/10 reason, the original pointer value is returned and the memory c ontents are unchanged. [948] Overfull \hbox (4.1005pt too wide) in paragraph at lines 53231--53231 \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 53231--53231 \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 53231--53231 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [949] Overfull \hbox (21.10475pt too wide) in paragraph at lines 53303--53303 \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 53303--53303 \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 53303--53303 \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 53303--53303 \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 53303--53303 []\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 53303--53303 \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 53303--53303 [][]\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 53303--53303 [][]\T1/cmtt/m/n/10 A pointer value of NULL will also be returned if this funct ion is invoked with [950] Overfull \hbox (5.62103pt too wide) in paragraph at lines 53348--53348 \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 53348--53348 \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 53348--53348 [][]\T1/cmtt/m/n/10 A pointer value of NULL is returned if this function is inv oked with the global [951] Underfull \hbox (badness 1490) in paragraph at lines 53417--53417 \T1/ppl/m/n/10.95 (+20) the pixel to WCS Map-ping (note, Overfull \hbox (7.69725pt too wide) in paragraph at lines 53392--53449 [][] [952] [953] [954] Underfull \hbox (badness 2103) in paragraph at lines 53586--53586 []|\T1/ppl/m/n/10.95 (+20) Used to set the at-tributes of the Underfull \hbox (badness 4291) in paragraph at lines 53594--53595 []|\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 53555--53606 [][] [955] [956] [957] Underfull \hbox (badness 4713) in paragraph at lines 53762--53762 []|\T1/ppl/m/n/9 (+20) Used to set the Units at-tribute of the Underfull \hbox (badness 3229) in paragraph at lines 53771--53772 []|\T1/ppl/m/n/9 (+20) Set from the Std-OfRest at-tribute of the Underfull \hbox (badness 2261) in paragraph at lines 53783--53783 []|\T1/ppl/m/n/9 (+20) Used to set the []Epoch[] at-tributes of the Underfull \hbox (badness 1931) in paragraph at lines 53788--53789 []|\T1/ppl/m/n/9 (+20) Set from the SourceVRF at-tribute of the Underfull \hbox (badness 3657) in paragraph at lines 53797--53798 []|\T1/ppl/m/n/9 (+20) Set from the SourceVel at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 53806--53806 []|\T1/ppl/m/n/9 (+20) Used to set the []Rest-Freq[] at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 53806--53807 []|\T1/ppl/m/n/9 (+20) Set from the Rest-Freq at-tribute of the Underfull \hbox (badness 1043) in paragraph at lines 53812--53812 []|\T1/ppl/m/n/9 (+20) Used to set the Rest-Freq at-tribute of the Underfull \hbox (badness 5817) in paragraph at lines 53812--53813 []|\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 53748--53821 [][] [958] [959] [960] [961] [962] [963] [964] [965] [966] [967] [968] [969] [970] [971] [972] [973] [974] [975] [976] [977] [978] [979] [980] Overfull \hbox (36.88722pt too wide) in paragraph at lines 55282--55285 \T1/ppl/m/n/10.95 (-20) class. These are flux-conserving al-ter-na-tives to the ex-ist-ing AST_RESAMPLE/astResample [981] [982] [983] [984] [985] [986] [987] [988] [989] [990] [991] [992] [993] [994] [995] [996] [997] [998] [999] [1000] [1001] [1002] [1003] [1004] [1005] [1006] (./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/enc/dvips/base/8 r.enc} Output written on sun211.pdf (1029 pages, 2792494 bytes). Transcript written on sun211.log. latex2html -noaddress sun211.tex This is LaTeX2HTML Version 2020.2 (Released July 1, 2020) by Nikos Drakos, Computer Based Learning Unit, University of Leeds. Revised and extended by: Marcus Hennecke, Ross Moore, Herb Swan and others ...producing markup for HTML version 5.0 Extension: loading /usr/share/latex2html/versions/unicode.pl *** Constructing conversion utf-8 -> Unicode *** HTML version: loading /usr/share/latex2html/versions/html5_0.pl *** processing declarations *** OPENING /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/sun211.tex Note: Working directory is /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/sun211 Note: Images will be generated in /tmp/l2h1451719 texexpand V2020.2 (Released July 1, 2020) Loading /usr/share/latex2html/styles/texdefs.perl... Warning: No implementation found for option: `twoside' for `starlink' package Warning: No implementation found for option: `11pt' for `starlink' package Reading ... %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% *** there was an unmatched closing } at the end of: } ,,,,,++...................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Reading aux file: /build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg/sun211.aux ... Processing macros ...,,,,,,,,,++............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... *** sub wrap_cmd_zref@newlabel failed: Illegal declaration of subroutine main::wrap_cmd_zref at (eval 497) line 1. . *** sub wrap_cmd_hyper@newdestlabel failed: Illegal declaration of subroutine main::wrap_cmd_hyper at (eval 498) line 1. ....... *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** *** no brace for \oldcontentsline , before: *** using "" as the argument instead; is this correct? *** . Cannot find matching bracket for 56697.. *** no brace for \oldcontentsline , before: {\oldnewlabel{<}{{<}{5}}7>> *** using "<" as the argument instead; is this correct? *** .. *** sub wrap_cmd_HyField@AuxAddToFields failed: Illegal declaration of subroutine main::wrap_cmd_HyField at (eval 500) line 1. . *** sub wrap_cmd_HyField@AuxAddToCoFields failed: Illegal declaration of subroutine main::wrap_cmd_HyField at (eval 501) line 1. ..............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,,................................................................................................................................................................,,.................................................................................................................................................,,....................,,...............................................................................................................................................................................,,.............................................,,.....,,..........,,.........................,,.....,,.....,,.............................................,,......................................................................,,...........................................................................................................................................................,,.....,,.............................................,,..............................,,..........,,................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. Translating ... 0/321:top of sun211: for sun211.html *** translating preamble *** .................... Warning: No implementation found for document class: starlink............. *** preamble done *** ;.,....;.. 1/321:section:.."Introduction" for node1.html ;..;...... 2/321:subsection:.."What Problems Does AST Tackle?" for node2.html ;..,...........;................... 3/321:subsection:.."Other Design Objectives" for node3.html ;..,........,.......,.,..........;....... 4/321:subsection:.."What Does ``AST'' Stand For?" for node4.html ;..;... 5/321:section:.."Overview of AST Concepts" for node5.html ;..; 6/321:subsection:..."Relationships Between Coordinate Systems" for node6.html ;..,,........;........... 7/321:subsection:..."Mappings Available" for node7.html ;..,............;....................................... 8/321:subsection:..."Compound Mappings" for node8.html ;..,,.....,,........,,......;.................. 9/321:subsection:.."Representing Coordinate Systems" for node9.html ;.,,..........,,.......;........................... 10/321:subsection:.."Networks of Coordinate Systems" for node10.html ;.,,.........;................ 11/321:subsection:.."Input/Output Facilities" for node11.html ;..............;....................... 12/321:subsection:.."Producing Graphical Output" for node12.html ;.....,,........;.................... 13/321:section:...."How To..." for node13.html ;...;... 14/321:subsection:..."...Obtain and Install AST" for node14.html ;.....; 15/321:subsection:..."...Structure an AST Program" for node15.html ;..,..;........ 16/321:subsection:...."...Build an AST Program" for node16.html ;..,..,....;......... 17/321:subsection:...."...Read a WCS Calibration from a Dataset" for node17.html ;..,....;............................ 18/321:subsection:..."...Validate WCS Information" for node18.html ;..,..;............ 19/321:subsection:..."...Display AST Data" for node19.html ;..,...;............ 20/321:subsection:...."...Convert Between Pixel and World Coordinates" for node20.html ;..,.....;................... 21/321:subsection:...."...Test if a WCS is a Celestial Coordinate System" for node21.html ;...,..;.... 22/321:subsection:...."...Test if a WCS is a Spectral Coordinate System" for node22.html ;.; 23/321:subsection:...."...Format Coordinates for Display" for node23.html ;..,...,.;......................... 24/321:subsection:..."...Display Coordinates as they are Transformed" for node24.html ;..,....;................ 25/321:subsection:..."...Read Coordinates Entered by a User" for node25.html ;...,...;.................. 26/321:subsection:...."...Create a New WCS Calibration" for node26.html ;...,.,...,.,.,.......;......................... 27/321:subsection:...."...Modify a WCS Calibration" for node27.html ;....,.,..,...,...;.......................... 28/321:subsection:...."...Write a Modified WCS Calibration to a Dataset" for node28.html ;...,..................;............................................................ 29/321:subsection:...."...Display a Graphical Coordinate Grid" for node29.html ;.,,.................;.................... 30/321:subsection:...."...Switch to Plot a Different Celestial Coordinate Grid" for node30.html ;...........;............. 31/321:subsection:..."...Give a User Control Over the Appearance of a Plot" for node31.html ;.............;................... 32/321:section:..."An AST Object Primer" for node32.html ;.,...;. 33/321:subsection:.."AST Objects" for node33.html ;....;..... 34/321:subsection:..."Object Creation and Pointers" for node34.html ;.....,...;................ 35/321:subsection:..."The Object Hierarchy" for node35.html ;................;...................... 36/321:subsection:..."Displaying Objects" for node36.html ;..,..........;.................. 37/321:subsection:..."Getting Attribute Values" for node37.html ;.............;.......... 38/321:subsection:..."Setting Attribute Values" for node38.html ;.......................,,,................;.................. 39/321:subsection:..."Testing, Clearing and Defaulting Attributes" for node39.html ;.............;.......... 40/321:subsection:..."Transforming Coordinates" for node40.html ;...............................;............ 41/321:subsection:..."Managing Object Pointers" for node41.html ;........;......... 42/321:subsection:..."AST Pointer Contexts---Begin and End" for node42.html ;............;............... 43/321:subsection:.."Exporting, Importing and Exempting AST Pointers" for node43.html ;...........;........... 44/321:subsection:.."AST Objects within Multi-threaded Applications" for node44.html ;....;............. 45/321:subsubsection:.."Locking AST Objects for Exclusive Use" for node45.html ;.......;...... 46/321:subsubsection:.."AST Pointer Contexts" for node46.html ;...;..... 47/321:subsection:..."Copying Objects" for node47.html ;........;.... 48/321:subsection:.."C Pointer Types" for node48.html ;........,,..,.....,..........;.................... 49/321:subsection:..."Error Detection" for node49.html ;..............................;................. 50/321:subsection:.."Sharing the Error Status" for node50.html ;........;..... 51/321:section:..."Inter-Relating Coordinate Systems (Mappings)" for node51.html ;...;.......... 52/321:subsection:..."The Mapping Class" for node52.html ;.....;......... 53/321:subsection:.."The Mapping Model" for node53.html ;..;....... 54/321:subsection:.."Changing Attributes of a Mapping" for node54.html ;...;....... 55/321:subsection:.."Input and Output Coordinate Numbers" for node55.html ;.......;........ 56/321:subsection:.."Forward and Inverse Transformations" for node56.html ;......;....... 57/321:subsection:..."Inverting Mappings" for node57.html ;........;.......... 58/321:subsection:.."Finding the Rate of Change of a Mapping Output" for node58.html ;.;.. 59/321:subsection:.."Reporting Coordinate Transformations" for node59.html ;...;................. 60/321:subsection:..."Handling Missing (Bad) Coordinate Values" for node60.html ;.......,,..;............... 61/321:subsection:..."Example---the UnitMap" for node61.html ;........;...... 62/321:subsection:..."Example---the PermMap" for node62.html ;..,,................,,,,........,,,...;............... 63/321:section:..."Compound Mappings (CmpMaps)" for node63.html ;..;... 64/321:subsection:..."Combining Mappings in Series" for node64.html ;.,,.,........;................. 65/321:subsection:.."Combining Mappings in Parallel" for node65.html ;..,,........;................... 66/321:subsection:..."The Component Mappings" for node66.html ;....;.............. 67/321:subsection:..."Creating More Complex Mappings" for node67.html ;........;....... 68/321:subsection:..."Example---Transforming Between Two Calibrated Images" for node68.html ;........;......... 69/321:subsection:..."Over-Complex Compound Mappings" for node69.html ;.......;................ 70/321:subsection:..."Simplifying Compound Mappings" for node70.html ;..,,...........,.....;........... 71/321:section:..."Representing Coordinate Systems (Frames)" for node71.html ;...;................... 72/321:subsection:.."The Frame Model" for node72.html ;.,,...;..... 73/321:subsection:..."Creating a Frame" for node73.html ;......;.. 74/321:subsection:..."Using a Frame as a Mapping" for node74.html ;..........;.................... 75/321:subsection:..."Frame Axis Attributes" for node75.html ;...................;.............. 76/321:subsection:..."Frame Attributes" for node76.html ;..,,...........................................................................;.... 77/321:subsection:..."Formatting Axis Values" for node77.html ;........,....;................ 78/321:subsection:..."Normalising Frame Coordinates" for node78.html ;........;.......... 79/321:subsection:..."Reading Formatted Axis Values" for node79.html ;...........,..........................;............... 80/321:subsection:..."Permuting Frame Axes" for node80.html ;.....,,.....;.... 81/321:subsection:.."Selecting Frame Axes" for node81.html ;............;................. 82/321:subsection:..."Calculating Distances, Angles and Offsets" for node82.html ;......,...........,....;............... 83/321:subsection:..."The Domain Attribute" for node83.html ;...,.,....,....,...........;..................... 84/321:subsection:..."Conventions for Domain Names" for node84.html ;.,,,,..,,.....................................;....... 85/321:subsection:..."The Unit Attribute" for node85.html ;...............,,..;................. 86/321:subsubsection:..."The Syntax for Unit Strings" for node86.html ;.....,,,.........,,,,.........,,,....,,,,,,,,,,,,,,,,,,,,............................,,,....,,......;........ 87/321:subsubsection:.."Side-effects of Changing the Unit attribute" for node87.html ;.;... 88/321:section:..."Celestial Coordinate Systems (SkyFrames)" for node88.html ;..;..... 89/321:subsection:.."The SkyFrame Model" for node89.html ;.......;.................... 90/321:subsection:.."Creating a SkyFrame" for node90.html ;......;. 91/321:subsection:.."Specifying a Particular Celestial Coordinate System" for node91.html ;......,..,.;............ 92/321:subsection:.."Attributes which Qualify Celestial Coordinate Systems" for node92.html ;....,,......................;............. 93/321:subsection:.."Using Default SkyFrame Attributes" for node93.html ;...........;......... 94/321:subsection:..."Formatting Celestial Coordinates" for node94.html ;....,,..,,,....................................................,.........;.................... 95/321:subsection:..."Reading Formatted Celestial Coordinates" for node95.html ;...,,.,..,..,,...,..,,.....,,.,,,,,......,,,,,......,,...;............................ 96/321:subsection:.."Representing Offsets from a Specified Sky Position" for node96.html ;...;.... 97/321:section:...."ss_specframesSpectral Coordinate Systems (SpecFrames)" for node97.html ;..;..... 98/321:subsection:.."The SpecFrame Model" for node98.html ;...;................ 99/321:subsection:.."Creating a SpecFrame" for node99.html ;......;. 100/321:subsection:.."Specifying a Particular Spectral Coordinate System" for node100.html ;.....,..;..... 101/321:subsection:.."Attributes which Qualify Spectral Coordinate Systems" for node101.html ;....,,............................;.......... 102/321:subsection:.."Using Default SpecFrame Attributes" for node102.html ;........,..........;........... 103/321:subsection:..."Creating Spectral Cubes" for node103.html ;.......,,,,,,,.;.......... 104/321:subsection:..."Handling Dual-Sideband Spectra" for node104.html ;.,,,..,..,,.....,,....,,,..,,...;........... 105/321:subsubsection:.."Aligning Dual-Sideband Spectra" for node105.html ;..............,,.......,,........,.;....................... 106/321:section:...."ss_timeframesTime Systems (TimeFrames)" for node106.html ;..;..... 107/321:subsection:.."The TimeFrame Model" for node107.html ;...;................... 108/321:subsection:.."Creating a TimeFrame" for node108.html ;......;. 109/321:subsection:.."Specifying a Particular Time System" for node109.html ;.....,..;...... 110/321:subsection:.."Attributes which Qualify Time Coordinate Systems" for node110.html ;....,,...............;........... 111/321:section:..."Compound Frames (CmpFrames)" for node111.html ;...;.... 112/321:subsection:.."Creating a CmpFrame" for node112.html ;........;.... 113/321:subsection:.."The Attributes of a CmpFrame" for node113.html ;........;................ 114/321:section:..."An Introduction to Coordinate System Conversions" for node114.html ;..;.................. 115/321:subsection:..."Converting between Celestial Coordinate Systems" for node115.html ;..,....................................;............................ 116/321:subsection:..."Converting between Spectral Coordinate Systems" for node116.html ;,,................;................. 117/321:subsection:.."Converting between Time Coordinate Systems" for node117.html ;.; 118/321:subsection:..."Handling SkyFrame Axis Permutations" for node118.html ;......,..,......;............... 119/321:subsection:..."Converting Between Frames" for node119.html ;.........;................. 120/321:subsection:..."The Choice of Alignment System" for node120.html ;..,,,.....;............. 121/321:section:..."Coordinate System Networks (FrameSets)" for node121.html ;.... Cannot find matching bracket for 26066.;............. 122/321:subsection:.."The FrameSet Model" for node122.html ;...,....;..... 123/321:subsection:..."Creating a FrameSet" for node123.html ;..........;...... 124/321:subsection:..."Adding New Frames to a FrameSet" for node124.html ;.................,,.........;....................... 125/321:subsection:..."The Base and Current Frames" for node125.html ;...........;............ 126/321:subsection:..."Referring to the Base and Current Frames" for node126.html ;.......;.............. 127/321:subsection:..."Using a FrameSet as a Mapping" for node127.html ;..........;...................... 128/321:subsection:..."Extracting a Mapping from a FrameSet" for node128.html ;........;....................... 129/321:subsection:..."Using a FrameSet as a Frame" for node129.html ;......,,.........................;............... 130/321:subsection:.."Extracting a Frame from a FrameSet" for node130.html ;......;......... 131/321:subsection:.."Removing a Frame from a FrameSet" for node131.html ;........;............. 132/321:section:..."Higher Level Operations on FrameSets" for node132.html ;.; 133/321:subsection:..."Creating FrameSets with astConvert" for node133.html ;......,,............;.................... 134/321:subsection:..."Converting between FrameSet Coordinate Systems" for node134.html ;.,,..............,...............;.................................. 135/321:subsection:..."Example---Registering Two Images" for node135.html ;...........,..........;......................... 136/321:subsection:..."Re-Defining a FrameSet Coordinate System" for node136.html ;.....,.......,,.......;........... 137/321:subsection:..."Example---Binning an Image" for node137.html ;.,...........;...... 138/321:subsection:..."Maintaining the Integrity of FrameSets" for node138.html ;..........................;................ 139/321:subsection:.."Merging FrameSets" for node139.html ;.,,..............;.......... 140/321:section:..."Saving and Restoring Objects (Channels)" for node140.html ;....;.......... 141/321:subsection:.."The Channel Model" for node141.html ;...;....... 142/321:subsection:..."Creating a Channel" for node142.html ;.......;.......... 143/321:subsection:..."Writing Objects to a Channel" for node143.html ;.......;...... 144/321:subsection:..."Reading Objects from a Channel" for node144.html ;..............;....... 145/321:subsection:.."Saving and Restoring Multiple Objects" for node145.html ;...;...... 146/321:subsection:..."Validating Input" for node146.html ;.,,,,.........;......... 147/321:subsection:.."Storing an ID String with an Object" for node147.html ;...........;........ 148/321:subsection:..."The Textual Output Format" for node148.html ;...............,.,.....;.............. 149/321:subsection:..."Controlling the Amount of Output" for node149.html ;..,........,....;........... 150/321:subsection:..."Controlling Commenting" for node150.html ;.........;... 151/321:subsection:.."Editing Textual Output" for node151.html ;...,....;....... 152/321:subsection:..."Mixing Objects with other Text" for node152.html ;.......;........ 153/321:subsection:..."Reading Objects from Files" for node153.html ;...................;......... 154/321:subsection:..."Writing Objects to Files" for node154.html ;..................;........... 155/321:subsection:..."Reading and Writing Objects to other Places" for node155.html ;...;......... 156/321:section:..."Storing AST Objects in FITS Headers (FitsChans)" for node156.html ;....;............ 157/321:subsection:..."The Native FITS Encoding" for node157.html ;....;........... 158/321:subsection:.."The FitsChan Model" for node158.html ;...,......,......;.............................................. 159/321:subsection:..."Creating a FitsChan" for node159.html ;......;...... 160/321:subsection:..."Addressing Cards in a FitsChan" for node160.html ;................,.;............ 161/321:subsection:..."Writing Native Objects to a FitsChan" for node161.html ;............;........................... 162/321:subsection:..."Extracting Individual Cards from a FitsChan" for node162.html ;.......;.............. 163/321:subsection:.."The Native FitsChan Output Format" for node163.html ;.......,,,.,.,....;...................... 164/321:subsection:..."Adding Individual Cards to a FitsChan" for node164.html ;............;... 165/321:subsection:..."Adding Concatenated Cards to a FitsChan" for node165.html ;......;........ 166/321:subsection:..."Reading Native Objects From a FitsChan" for node166.html ;........;.................... 167/321:subsection:.."Saving and Restoring Multiple Objects in a FitsChan" for node167.html ;....;...... 168/321:subsection:.."Mixing Native Objects with Other FITS Cards" for node168.html ;....;....... 169/321:subsection:..."Finding and Changing Cards in a FitsChan" for node169.html ;..................;........ 170/321:subsection:..."Source and Sink Functions for FitsChans" for node170.html ;....;............................ 171/321:section:..."Using Foreign FITS Encodings" for node171.html ;...;...... 172/321:subsection:..."The Foreign FITS Encodings" for node172.html ;...,,....................................;......... 173/321:subsection:..."Limitations of Foreign Encodings" for node173.html ;..,.......;................. 174/321:subsection:..."Identifying Foreign Encodings on Input" for node174.html ;....................;.......... 175/321:subsection:..."Reading Foreign WCS Information from a FITS Header" for node175.html ;.............,.......;...................................................................... 176/321:subsection:..."Removing WCS Information from FITS Headers---the Destructive Read" for node176.html ;.............;............... 177/321:subsection:..."Propagating WCS Information through Data Processing Steps" for node177.html ;....,.......;..................... 178/321:subsection:..."Writing Foreign WCS Information to a FITS Header" for node178.html ;...............,......;............... 179/321:section:..."Storing AST Objects as XML (XmlChan)" for node179.html ;...........,...........;............ 180/321:subsection:.."Reading IVOA Space-Time-Coordinates XML (STC-X) Descriptions" for node180.html ;.....;............. 181/321:section:..."Reading and writing STC-S descriptions (StcsChans)" for node181.html ;...;..... 182/321:section:..."Creating Your Own Private Mappings (IntraMaps)" for node182.html ;.; 183/321:subsection:.."The Need for Extensibility" for node183.html ;....;.. 184/321:subsection:.."The IntraMap Model" for node184.html ;...;.................. 185/321:subsection:..."Limitations of IntraMaps" for node185.html ;......;... 186/321:subsection:..."Writing a Transformation Function" for node186.html ;..........;........................... 187/321:subsection:..."Registering a Transformation Function" for node187.html ;..........,..;................. 188/321:subsection:.."Creating an IntraMap" for node188.html ;.........;............... 189/321:subsection:..."Restricted Implementations of Transformation Functions" for node189.html ;..........;...... 190/321:subsection:..."Variable Numbers of Coordinates" for node190.html ;..............;......... 191/321:subsection:..."Adapting a Transformation Function to Individual IntraMaps" for node191.html ;........;....... 192/321:subsection:...."MaxTranSimplifying IntraMaps" for node192.html ;...................;.................... 193/321:subsection:..."Writing and Reading IntraMaps" for node193.html ;.....;.............. 194/321:subsection:..."Managing Transformation Functions in Libraries" for node194.html ;.......;......... 195/321:section:..."Producing Graphical Output (Plots)" for node195.html ;..;... 196/321:subsection:.."The Plot Model" for node196.html ;.........;....... 197/321:subsection:.."Plotting Symbols" for node197.html ;.......;.. 198/321:subsection:..."Plotting Geodesic Curves" for node198.html ;............;......... 199/321:subsection:.."Plotting Curves Parallel to Axes" for node199.html ;.......;....... 200/321:subsection:..."Plotting Generalized Curves" for node200.html ;...;...... 201/321:subsection:..."Clipping" for node201.html ;..........;....... 202/321:subsection:.."Using a Plot as a Mapping" for node202.html ;.....;................ 203/321:subsection:.."Using a Plot as a Frame" for node203.html ;...;................. 204/321:subsection:..."Regions of Valid Physical Coordinates" for node204.html ;....;............ 205/321:subsection:.."Plotting Borders" for node205.html ;.......;..... 206/321:subsection:.."Plotting Text" for node206.html ;........;..... 207/321:subsection:..."Plotting a Grid" for node207.html ;......;........ 208/321:subsection:..."Controlling the Appearance of Sub-strings" for node208.html ;.,....;............ 209/321:subsection:..."Producing Logarithmic Axes" for node209.html ;.,.....;.... 210/321:subsection:..."Choosing a Graphics Package" for node210.html ;.,........;.............. 211/321:section:.."Compiling and Linking Software that Uses AST" for node211.html ;...;.. 212/321:subsection:..."Accessing the ``ast.h'' Header File" for node212.html ;...........;. 213/321:subsection:..."Linking with AST Facilities" for node213.html ;.........,.,.....;........ 214/321:subsection:.."Building ADAM Applications that Use AST" for node214.html ;......,.......;................... 215/321:section:..."The AST Class Hierarchy" for node215.html ;....;... 216/321:section:..."AST Function Descriptions" for node216.html ;........................,,............................................................................,,...........................................,..........................,,,,..........................................................,,,.....................................................................,,...............,..........................,,,.......................................,,...........,,..,...,,,,................................,,,,,,,,,,.........................................................................................,,,,,,............................,,,,.....................,.......................,,.....................................,,,.......................,.....,,,........................,,..................,......,....................,.......................,,......,,,......,,...............,.......................,.................................,..................,...................,,,,..........................................,......................,,,,,,.............................................,............,,,.............................,,,....,,........................................,,..........,,,...........................,,,..............................................................................,,,,................................................,,,,...............,,.........................,....................................................................,,.......................,,,,.......................,..................,,,,.....................................................,,,,.............................................,,....................,,,,..................................,,,,.........................,,.....................,,,,.................................................................................................................................................,,..,,,,.................,,,,,,,............................................,..........,......,,.......,,,,,,............................,,,,..........................,,......................,,,,,,.................,................................,........................................,,...............................,,,,,,,,..............................,.....................,,.................,.......................,,..................,..............,,,,.......................................................,,,,..,......................,............................................................,..........,.................,,.............................................................................................................................................................,,,,.........................................................................................................................................................................,,,,,,...................................,,,,,,.....................................,.................,,,......................,.................,,,..................................................,,.......................,,.....................,,,,.................................................,,,.....................................,,.............,,................,,,,,....,,,,,,...,,,,..,..................................,................,,,.............,,,,..........................................,,,,..................,,.,.,.,.,.,.,,.................................,,,,,,,,,...,,,,.............................,,...............................,,..........,,..............................................,,..............,,.......,,,,.....................,,,,..................,,,....................,,.....................,,..................,,................,,,,...................................,,,,......................,......,.....,.....................................,,................,.............,,................,,..............................,,.................,,.............................,.............,...........,,........................................,,..................................,........,.............................................................................,........,......,,,................,,,..................,,,..........,,,..,.,.........,,,....................................................,,,,,.............................................,............................,.........................................,,.............................,,................,,............,,............,...........,....................................,,,,.......................................,................,,,....................................,,,,,,,,.................................................................,......,,,,..,,,,,...,,,,......,,,,................,,,,,,,,.......,,....................,............,,,,..,,.,,,,.,,,,.,,,,..........................................................,...................................,,...............................,..............,,,.............................,....,........................................,,................,,,.....................,,..........,,,,,,,,....,,,,,,,...........,,.............,,,,,,.....,.............................,,,,,,,,..........,,,,,,,,,,,,...........,,.......,..........,,,,,,.....,...............,..........................,,,,..................,,,,,,,,..........,,,,,,,,,,......,,.............,,,,,,.....,.......................................,,....................,,...................,,................,,.............,,,,,,....,,,,,,,.............,,,,,,.....,................,.................,,,,,,....,,,,,,,..........,,,,,,.....,................,.................,,,,,,,,....,,,,,,..............,,...,,,,,,.....,........................................,,,..............,,,,...........................,,.........,,,..........,............,,,,,.............................,,........................................,,.........................................,,.,,,,.........,,,,,,,,........................,..............................,,.......,,,,,,............................,,,,.........................,,,.........................,,,,...................................................,,,............,.,...........................................,,,.,,,,..,.,..............................................................,,.,,...........,..,..,,.,.................................,,..,,.,,........................................................................,,...,.,.,.,.............................................,,,,.....,,.,,..,.,...................................,,..................................,,.................,.....................................................................................................................................................................................,,,,,,.,,.,,.,,,,,.,,,,.,,.,,.,,,,.,,.,,.,,,,.,,.,,.,,....................................,.,,.,.,.,,,,.,,,,...,.,..,,.,,.............................,,,..........................,,.................................................,...............,....................................,,......................,........................,,,,,,...........................................,.......,...,........................,,,......................,..............,,,,..................................................,...........................,.........................,,...,,,,.....................,,,,,,,............................................,...........................................,.........,,............,,,,,,............................,,,,.........................,,...........................,,...................,,,,...........,,.......................,............,...................,,..............................................................................,,,,..............................................................,,,............................................................,,,..............................................................,....,,.....................,,,,,..................................................,..............,,,.,,,,..............,,..........................,,.......................................,,......,,,...........................,,,..................................................................................,,,,...........,,..........................................................,,,,,.................................................,...........,.....,,,,.................................,.......,...........,,.............,,............,,,..................,...................,,,.................,,..................................................,,...................,,,,,,,,,,,,,..............................,,,..........,.,,,,,,,,,,,,,,,,,,,,,,,,,,......................................................,,...............................,,,......................................,,...........................,............,,.,,,,.,,,,...............,,,,,,,,,,,,,...............................,.......................................................................................................................................,,,,,,...........,,,,,,.........,,,,..,,.............................,,,,.,,..................................................,,,,.....................................,,,,,,...,,,,...................,,,,,,,,,,,,,,...........................................,.................................,,.......,,.......................................................................................................................................,,,,,,...........,,,,................,,.............................................................................................................,,...............................,,,,.....................................,,.............,,.....................................,,.........,.............................,,...........,,.............................,........,,.......,,.,,,,..,,,,,,,,................,,,,,,,,,,,,,,..............................,.............................................................,,.............................................................................................,,.......,,,,,,................................................,,.,.,,,,,,.,,,,,.,,,.,,.,,,,,.............................................................,,............,,,,........................................................................................................................................,,,,.......................................,,,............................,...............,,............................,,,..........................................................,,................................................................,,,,,....,,,,,,,,................................................................................,............,,,,,,,,..............,,.,,..................,,.,.,....,.,............................,,,,,,,,,.................,,.....................,,...................,,,.............................,,..,................,,...............................,,................,,.......................,...........,.........,............,,.............,,.......................................,,.................................................................,,.......................,,................................................................................................................................................................,,..........................................,,.............................................................................................................................................................................................................,,,,..............................,.................,,.......................................................,,.............................................,,..............................,..,..,........................,..,,,,.....,,.............................................................,..,,,,.....,,.............................................................,..,,,,.....,,....................................................,............,..,,,,.....,,....................................................,........................,,,,,,..............................................,,...................................................,,,,,....................................,,,,.............,,.....................,....................,,,,,...........................,,....................,..................,,,....................,,,.........................................................,..........................................................,,..........................................................................................................................................,.,............................................,,.......................................,,...................................,,..........,.................................,.......................................,,.......,..................................................................................,,,,..................................,.............,,,..............................................................................,,,....................................................................................,........................,,,............,,,,..........,,,,..........,,,,..........,,,,..........,,,,............,,,,,............,,,.......................,,,,,,.........,,,,,,,,,,,,.................,,.........,,....,,..............................................,,..,,,,.....,,.......................................................,,,,.,,.,,..............,,,,,,..........,,,....,,,,..........,,.................,,,..................,,....................................,,......................................................................................,..........,,.....................................................,,...........................................,,.......................,............,...........................,,,,............................,,.................................,,.......................................,,............................................................................,...............,,..................................,............,,...................,.........................,,,,,,.....................................................,,,,,,.............................................,,.........................,............;........................................................................................................................................................................................................................................................................ 217/321:section:..."AST Attribute Descriptions" for node217.html ;........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................,....................................................,,,,,,,,.................................................................................................................................................................,,,,................................................,,,,,,................................................................................................................................................................................................................,,.,,..............................,.....................................................................................................................................,,,,.,.,,,.,,.,,.,.,.,.,.,.,.,.,.,.,.,,.,,.,.,.........................................................................................................................................,,,,.,,.,,.........................,.......................................................................................,.................................................................................................................................................................,............,.....................................................................................................................................................................................................................................................................................................................................,,,,..........................................................................,,,,...........................................................................................................................................................,,......................................................................................................................,...................................................................,,,,.....................................................................................................................,.........................................................................................................................................................................................................,............................................................................,...........................................,.............................................,...............................................................................................................................................................................................,,,,,,............................................,....................................................................,,............................................................................................................................................................................................................................................................................................................,....................................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,,,,,,,........................................,,,...............................................................................................................................................................................,.,.,,,.,,,.............,.............,,,,...........................................................................,,.........................................................................................................................................................,..............,,,,.....,,,,.................,................................,..............................................................................................................................................................................................................................................................................................................,,.,,,,,,.,,,,.,,..,,,,.,,.,,.,,,,.,,.,,.,,...,,.,,,,........................................................................................................................................................;......................................................................................................................................................................................................................... 218/321:section:..."AST Class Descriptions" for node218.html ;...........................................................................,,,....,,..................................................................................................................................................................................,,,,,,,,,,....................................................................................................................,,,,..........,,,,................................................................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,..,,,,.....,,,,.,,,,.,,,,...............................................................................................................,,,,.,,,,.,,,,.............................................................................................................,,,,.....................................................................................................................,,,,...,,,,.....,,,,.........................................................................,,,,.......................................................................................................................................................................................................................................................................................................................................................................................................,,,,.,,,,.............,..........................,,..............................................................,,,,..........................................................................................................................................................................................................................................................,............................,.........,...............,.........,.....................,,.....,,........................................................................................................................,,,,............................................................................................................................................................................................................................................................................................................................;................................................................... 219/321:section:..."UNIX Command Descriptions" for node219.html ;.......................................................................................................................................................................................................................................................;... 220/321:section:..."AST Memory Management and Utility Functions" for node220.html ;.....,.........,..,,,,.,.........................,,,,.,.............................,,,,,,,,,........................................................................,................,................,,,...........................,......,.........,,..............,,..............,.......,,,,..,.............,,....,,,,...,............,,,,,,,.........,....,.............,,,,...,..........................,,,,,..,...,.,.,.,.,.,.,...................,.................................................................,......,,,....................................,,..........,,........,,......................,.............,............................,,...............,......,............,,,...................,,.....................,,,,......................,...............;................................................ 221/321:section:...."FitsWcsCoverageFITS-WCS Coverage" for node221.html ;....;......... 222/321:subsection:.."Paper I - General Linear Coordinates" for node222.html ;..,,.............................................................................;.......... 223/321:subsubsection:.."Requirements for a Successful Write Operation" for node223.html ;.;.... 224/321:subsubsection:..."Use and Choice of CTYPEi keywords" for node224.html ;..;............. 225/321:subsubsection:.."Choice of Reference Point" for node225.html ;.,...;.......... 226/321:subsubsection:.."Choice of Axis Ordering" for node226.html ;,,....;....... 227/321:subsubsection:.."Alternate Axis Descriptions" for node227.html ;..;..... 228/321:subsection:.."Paper II - Celestial Coordinates" for node228.html ;..,,........................................................;....... 229/321:subsubsection:.."Requirements for a Successful Write Operation" for node229.html ;.,..;......... 230/321:subsubsection:.."Choice of LONPOLE/LATPOLE" for node230.html ;.,......,..;.................. 231/321:subsubsection:.."User Defined Fiducial Points" for node231.html ;....;.............. 232/321:subsubsection:.."Common Non-Standard Features" for node232.html ;.,..............;.................. 233/321:subsection:.."Paper III - Spectral Coordinates" for node233.html ;..,,,..........................................................................;....... 234/321:subsubsection:.."Requirements for a Successful Write Operation" for node234.html ;.,...;....... 235/321:subsubsection:.."Common Non-Standard Features" for node235.html ;.,.;. 236/321:subsection:.."Paper IV - Coordinate Distortions" for node236.html ;...;...... 237/321:subsubsection:.."The ``-SIP'' distortion code" for node237.html ;......;........ 238/321:section:...."changes_and_new_featuresRelease Notes" for node238.html ;.; 239/321:subsection:.."Changes Introduced in V1.1" for node239.html ;..,.............;........................................ 240/321:subsection:.."Changes Introduced in V1.2" for node240.html ;..,.,,,,.,,......,,.............;............................. 241/321:subsection:.."Changes Introduced in V1.3" for node241.html ;..,,,,,.........;..... 242/321:subsection:.."Changes Introduced in V1.4" for node242.html ;..,...............;............... 243/321:subsection:.."Changes Introduced in V1.5" for node243.html ;..,...,.....,........,..;..................................... 244/321:subsection:.."Changes Introduced in V1.6" for node244.html ;..,...........,,......;........................ 245/321:subsection:.."Changes Introduced in V1.7" for node245.html ;..,..,.,,...........;................ 246/321:subsection:.."Changes Introduced in V1.8-2" for node246.html ;..,,,,....;........... 247/321:subsection:.."Changes Introduced in V1.8-3" for node247.html ;..,...;.... 248/321:subsection:.."Changes Introduced in V1.8-4" for node248.html ;..,....;..... 249/321:subsection:.."Changes Introduced in V1.8-5" for node249.html ;..,..;.. 250/321:subsection:.."Changes Introduced in V1.8-7" for node250.html ;..,.....;....... 251/321:subsection:.."Changes Introduced in V1.8-8" for node251.html ;..,.....;........ 252/321:subsection:.."Changes Introduced in V1.8-13" for node252.html ;..,.........;................ 253/321:subsection:.."Changes Introduced in V2.0" for node253.html ;.,...,...............;.................................. 254/321:subsection:.."Changes Introduced in V3.0" for node254.html ;..,..,...............................;...................................... 255/321:subsection:.."Changes Introduced in V3.1" for node255.html ;..,..;... 256/321:subsection:.."Changes Introduced in V3.2" for node256.html ;..,...................;................... 257/321:subsection:.."Changes Introduced in V3.3" for node257.html ;..,..........;....... 258/321:subsection:.."Changes Introduced in V3.4" for node258.html ;..,........;........... 259/321:subsection:.."Changes Introduced in V3.5" for node259.html ;..,.........;............ 260/321:subsection:.."Changes Introduced in V3.6" for node260.html ;..,.......;........ 261/321:subsection:.."Changes Introduced in V3.7" for node261.html ;..,..;........ 262/321:subsection:.."Changes Introduced in V4.0" for node262.html ;..,...;.... 263/321:subsection:.."Changes Introduced in V4.1" for node263.html ;..,.,,........;.................. 264/321:subsection:.."Changes Introduced in V4.2" for node264.html ;..,..................;...................... 265/321:subsection:.."Changes Introduced in V4.3" for node265.html ;..,...;... 266/321:subsection:.."Changes Introduced in V4.4" for node266.html ;..,.........;..................... 267/321:subsection:.."Changes Introduced in V4.5" for node267.html ;..,.........;........... 268/321:subsection:.."Changes Introduced in V4.6" for node268.html ;..,.....;...... 269/321:subsection:.."Changes Introduced in V5.0" for node269.html ;..,.....;....... 270/321:subsection:.."Changes Introduced in V5.1" for node270.html ;..,...............;..................... 271/321:subsection:.."Changes Introduced in V5.2" for node271.html ;..,...........;................ 272/321:subsection:.."Changes Introduced in V5.3" for node272.html ;..,....;......... 273/321:subsection:.."Changes Introduced in V5.3-1" for node273.html ;..,.................;.................... 274/321:subsection:.."Changes Introduced in V5.3-2" for node274.html ;..,.......;....... 275/321:subsection:.."Changes Introduced in V5.4-0" for node275.html ;..,.......;....... 276/321:subsection:.."Changes Introduced in V5.5-0" for node276.html ;..,..;..... 277/321:subsection:.."Changes Introduced in V5.6-0" for node277.html ;..,......;....... 278/321:subsection:.."ChangesIntroduced in V5.6-1" for node278.html ;..,....;.... 279/321:subsection:.."Changes Introduced in V5.7-0" for node279.html ;..,.......;.... 280/321:subsection:.."Changes Introduced in V5.7-1" for node280.html ;..,....;....... 281/321:subsection:.."Changes Introduced in V5.7-2" for node281.html ;..,.........;........... 282/321:subsection:.."Changes Introduced in V6.0" for node282.html ;..,......;... 283/321:subsection:.."Changes Introduced in V6.0-1" for node283.html ;..,..,,..;.. 284/321:subsection:.."Changes Introduced in V7.0.0" for node284.html ;..,...;.. 285/321:subsection:.."Changes Introduced in V7.0.1" for node285.html ;..,..; 286/321:subsection:.."Changes Introduced in V7.0.2" for node286.html ;..,..;.. 287/321:subsection:.."Changes Introduced in V7.0.3" for node287.html ;..,......;..... 288/321:subsection:.."Changes Introduced in V7.0.4" for node288.html ;..,..; 289/321:subsection:.."Changes Introduced in V7.0.5" for node289.html ;..,..;.. 290/321:subsection:.."Changes Introduced in V7.0.6" for node290.html ;..,...;. 291/321:subsection:.."Changes Introduced in V7.1.0" for node291.html ;..,.....;......... 292/321:subsection:.."Changes Introduced in V7.1.1" for node292.html ;..,...;...... 293/321:subsection:.."Changes Introduced in V7.2.0" for node293.html ;..,..;.. 294/321:subsection:.."Changes Introduced in V7.3.0" for node294.html ;..,....;........ 295/321:subsection:.."Changes Introduced in V7.3.1" for node295.html ;..,..; 296/321:subsection:.."Changes Introduced in V7.3.2" for node296.html ;..,....;... 297/321:subsection:.."Changes Introduced in V7.3.3" for node297.html ;..,...;... 298/321:subsection:.."Changes Introduced in V7.3.4" for node298.html ;..,...;.. 299/321:subsection:.."Changes Introduced in V8.0.0" for node299.html ;..,.....;. 300/321:subsection:.."Changes Introduced in V8.0.1" for node300.html ;..,..;........ 301/321:subsection:.."Changes Introduced in V8.0.2" for node301.html ;.,.;.. 302/321:subsection:.."Changes Introduced in V8.0.3" for node302.html ;.,..;... 303/321:subsection:.."Changes Introduced in V8.0.4" for node303.html ;.,........;........... 304/321:subsection:.."Changes Introduced in V8.0.5" for node304.html ;.,....;...... 305/321:subsection:.."Changes Introduced in V8.1.0" for node305.html ;.,..; 306/321:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V8.2" for node306.html ;.,...;........ 307/321:subsection:.."Changes Introduced in V8.3" for node307.html ;.,...;... 308/321:subsection:.."Changes Introduced in V8.4" for node308.html ;.,..........;............ 309/321:subsection:.."Changes Introduced in V8.5" for node309.html ;.,.......;............... 310/321:subsection:.."Changes Introduced in V8.6.2" for node310.html ;.,.......;................. 311/321:subsection:.."Changes Introduced in V8.6.3" for node311.html ;.,.....;... 312/321:subsection:.."Changes Introduced in V8.7.0" for node312.html ;.,....;..... 313/321:subsection:.."Changes Introduced in V8.7.1" for node313.html ;.,...;..... 314/321:subsection:.."Changes Introduced in V8.7.2" for node314.html ;.,.....;.... 315/321:subsection:.."Changes Introduced in V9.0.0" for node315.html ;.,...;. 316/321:subsection:.."Changes Introduced in V9.0.2" for node316.html ;.,..;.... 317/321:subsection:.."Changes Introduced in V9.1.0" for node317.html ;.,....;.... 318/321:subsection:.."Changes Introduced in V9.1.2" for node318.html ;.,..;. 319/321:subsection:.."Changes Introduced in V9.1.3" for node319.html ;.,....;... 320/321:subsection:...."changeslist_of_most_recent_changesChanges Introduced in V9.2.0" for node320.html ;.,....;.. 321/321:sectionstar:.."About this document ..." for node321.html ;;. . Doing footnotes ... Writing image file ... Translating images to PDF using pdflatex ... This is pdfTeX, Version 3.14159265-2.6-1.40.21 (TeX Live 2020/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./images.tex LaTeX2e <2020-02-02> patch level 5 L3 programming layer <2020-09-24> *** processing images *** Doing section links ...................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... Copying navigation icons ... *** Adding document-specific styles *** *********** WARNINGS *********** No implementation found for style `starlink' Substitution of arg to newlabelxx delayed. ? brace missing for \oldcontentsline Unknown commands: xlabel stardoccategory sstitemlist sstinvocation stardocsource htmladdnormallinkfoot stardoccopyright sstroutine startitlepic sstapplicability let stardocauthors sstexamplesubsection stardocabstract sstparameters stardocdate sstdiytopic sstattributetype stardocnumber scfrontmatter sstsubsection xref sstexamples stardocinitials includegraphics stardocmanual protected_at_file_at_percent sstreturnedvalue stardocversion sstnotes htmlref sstitem htmladdnormallink sstdescription stardoctitle sstdiylist cleardoublepage Done. rm -f sun211/sun211.html sun211/WARNINGS make[2]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_installdocs make[1]: Leaving directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_installchangelogs -i dh_perl -i dh_link -i dh_strip_nondeterminism -i dh_compress -i dh_fixperms -i debian/rules override_dh_missing make[1]: Entering directory '/build/starlink-ast-EXokvp/starlink-ast-9.2.3+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/x86_64-linux-gnu/libstarlink_ast.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_err.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf3d.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_2.0.so.9.2.3 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_3.2.so.9.2.3 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_grf_5.6.so.9.2.3 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pass2.so.9.2.3 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot.so.9.2.3 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.a exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.la exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.so exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.so.9 exists in debian/tmp but is not installed to anywhere dh_missing: warning: usr/lib/x86_64-linux-gnu/libstarlink_ast_pgplot3d.so.9.2.3 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 (661), 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.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 "x86_64-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/starlink-ast-EXokvp/starlink-ast-9.2.3+dfsg' dh_installdeb -i dh_gencontrol -i dh_md5sums -i dh_builddeb -i dpkg-deb: building package 'libstarlink-ast-doc' in '../libstarlink-ast-doc_9.2.3+dfsg-1_all.deb'. dpkg-genbuildinfo --build=all dpkg-genchanges --build=all >../starlink-ast_9.2.3+dfsg-1_all.changes dpkg-genchanges: info: binary-only arch-indep upload (source code and arch-specific packages not included) dpkg-source --after-build . dpkg-buildpackage: info: binary-only upload (no source included) I: running special hook: sync-out /build/starlink-ast-EXokvp /tmp/starlink-ast-9.2.3+dfsg-1xtfm0wu3 I: cleaning package lists and apt cache... W: deleting files in /tmp: texfonts I: creating tarball... I: done I: removing tempdir /tmp/mmdebstrap.DR52AIoVV5... I: success in 2480.4173 seconds md5: Value of 'md5' differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb md5: Size differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb sha1: Value of 'sha1' differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb sha1: Size differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb sha256: Value of 'sha256' differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb sha256: Size differs for libstarlink-ast-doc_9.2.3+dfsg-1_all.deb Checksums: FAIL diffoscope run passed