[python-astropy] 05/05: New binary package astropy-utils. Conflicts with pyfits-utils.
Ole Streicher
olebole at moszumanska.debian.org
Sat Apr 18 10:14:55 UTC 2015
This is an automated email from the git hooks/post-receive script.
olebole pushed a commit to branch debian
in repository python-astropy.
commit 6ad42bafc867466573eb14a20640445427ec9d81
Author: Ole Streicher <olebole at debian.org>
Date: Sat Apr 18 12:14:31 2015 +0200
New binary package astropy-utils. Conflicts with pyfits-utils.
---
debian/astropy-utils.install | 1 +
debian/astropy-utils.manpages | 7 +++
debian/changelog | 1 +
debian/control | 32 +++++++++++
debian/fits2bitmap.1 | 58 +++++++++++++++++++
debian/fitscheck.1 | 71 +++++++++++++++++++++++
debian/fitsdiff.1 | 87 ++++++++++++++++++++++++++++
debian/fitsheader.1 | 36 ++++++++++++
debian/samp_hub.1 | 130 ++++++++++++++++++++++++++++++++++++++++++
debian/volint.1 | 13 +++++
debian/wcslint.1 | 13 +++++
11 files changed, 449 insertions(+)
diff --git a/debian/astropy-utils.install b/debian/astropy-utils.install
new file mode 100644
index 0000000..e772481
--- /dev/null
+++ b/debian/astropy-utils.install
@@ -0,0 +1 @@
+usr/bin
diff --git a/debian/astropy-utils.manpages b/debian/astropy-utils.manpages
new file mode 100644
index 0000000..d6970ac
--- /dev/null
+++ b/debian/astropy-utils.manpages
@@ -0,0 +1,7 @@
+debian/fits2bitmap.1
+debian/fitscheck.1
+debian/fitsdiff.1
+debian/fitsheader.1
+debian/samp_hub.1
+debian/volint.1
+debian/wcslint.1
diff --git a/debian/changelog b/debian/changelog
index c7a778d..8f61daf 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,7 @@ python-astropy (1.0.2-1) UNRELEASED; urgency=low
* New upstream version.
* Create upstream/metadata with bibliographic information
* Create debci control file
+ * New binary package astropy-utils. Conflicts with pyfits-utils.
-- Ole Streicher <olebole at debian.org> Thu, 16 Apr 2015 22:15:02 +0200
diff --git a/debian/control b/debian/control
index 0295152..67fa49a 100644
--- a/debian/control
+++ b/debian/control
@@ -64,3 +64,35 @@ Description: Core functionality for performing astrophysics with Python (doc)
intended to work with the core package.
.
This package contains the package documentation.
+
+Package: astropy-utils
+Architecture: all
+Depends: python-astropy, ${misc:Depends}, ${python:Depends}
+Breaks: fitscheck (<< 1:3.1.2-1~),
+ pyfits-tools (<<1:3.3-2~),
+ python-pyfits (<< 1:3.0.7-2~)
+Replaces: fitscheck (<< 1:3.1.2-1~),
+ pyfits-tools (<<1:3.3-2~),
+ python-pyfits (<< 1:3.0.7-2~)
+Description: Command line tools from astropy
+ The astropy package contains core functionality and some common tools
+ needed for performing astronomy and astrophysics research with Python.
+ .
+ This package contains the tools that come with astropy:
+ .
+ * fitscheck: Detect and fix FITS standards violations
+ .
+ * fits2bitmap: Create a bitmap file from a FITS image.
+ .
+ * fitsdiff: Compare two FITS image files and report the differences in
+ header keywords and data.
+ .
+ * fitsheader: Print the header(s) of one or more FITS file(s) to the
+ standard output in a human-readable format.
+ .
+ * samp_hub: SAMP Hub Server.
+ .
+ * volint: Check a VOTable file for compliance to the VOTable specification
+ .
+ * wcslint: Check the WCS keywords in a FITS file for compliance against
+ the standards
diff --git a/debian/fits2bitmap.1 b/debian/fits2bitmap.1
new file mode 100644
index 0000000..8d044cc
--- /dev/null
+++ b/debian/fits2bitmap.1
@@ -0,0 +1,58 @@
+.TH FITS2BITMAP 1 "April 2015" "fits2bitmap" "astropy 1.0.2"
+.SH NAME
+fits2bitmap \- Create a bitmap file from a FITS image.
+.SH DESCRIPTION
+usage: fits2bitmap [\-h] [\-e hdu] [\-o filename] [\-\-scale SCALE] [\-\-power POWER]
+.IP
+[\-\-asinh_a ASINH_A] [\-\-min_cut MIN_CUT] [\-\-max_cut MAX_CUT]
+[\-\-min_percent MIN_PERCENT] [\-\-max_percent MAX_PERCENT]
+[\-\-percent PERCENT] [\-\-cmap colormap_name]
+filename [filename ...]
+.SS "positional arguments:"
+.TP
+filename
+Path to one or more FITS files to convert
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-e\fR hdu, \fB\-\-ext\fR hdu
+specify the HDU extension number or name
+.TP
+\fB\-o\fR filename
+Filename for the output image (Default is a PNG file
+with the same name as the FITS file)
+.TP
+\fB\-\-scale\fR SCALE
+Type of image scaling ("linear", "sqrt", "power",
+"log", or "asinh")
+.TP
+\fB\-\-power\fR POWER
+Power index for "power" scaling
+.TP
+\fB\-\-asinh_a\fR ASINH_A
+The value in normalized image where the asinh curve
+transitions from linear to logarithmic behavior (used
+only for "asinh" scaling)
+.TP
+\fB\-\-min_cut\fR MIN_CUT
+The pixel value of the minimum cut level
+.TP
+\fB\-\-max_cut\fR MAX_CUT
+The pixel value of the maximum cut level
+.TP
+\fB\-\-min_percent\fR MIN_PERCENT
+The percentile value used to determine the minimum cut
+level
+.TP
+\fB\-\-max_percent\fR MAX_PERCENT
+The percentile value used to determine the maximum cut
+level
+.TP
+\fB\-\-percent\fR PERCENT
+The percentage of the image values used to determine
+the pixel values of the minimum and maximum cut levels
+.TP
+\fB\-\-cmap\fR colormap_name
+matplotlib color map name
diff --git a/debian/fitscheck.1 b/debian/fitscheck.1
new file mode 100644
index 0000000..3406852
--- /dev/null
+++ b/debian/fitscheck.1
@@ -0,0 +1,71 @@
+.TH fitscheck 1 "April 2015" "fitscheck" "astropy 1.0.2"
+.SH NAME
+fitscheck \- script to detect and fix FITS standards violations
+.SH SYNOPSIS
+.B fitscheck
+[\fIOPTION\fR]... [\fIFILE\fR]...
+.SH DESCRIPTION
+.PP
+\fBfitscheck\fR is a command line script based on pyfits for verifying
+and updating the CHECKSUM and DATASUM keywords of FITS files.
+\fBitscheck\fR can also detect and often fix other FITS standards
+violations. \fBfitscheck\fR facilitates re\-writing the non-standard
+checksums originally generated by pyfits with standard checksums which
+will interoperate with cfitsio.
+.PP
+\fBfitscheck\fR will refuse to write new checksums if the checksum keywords
+are missing or their values are bad. Use \fB\-\-force\fR to write new
+checksums regardless of whether or not they currently exist or pass.
+Use \fB\-\-ignore-missing\fR to tolerate missing checksum keywords without
+comment.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display terse usage information (help).
+.TP
+\fB\-k\fR [\fIstandard\fR | \fInonstandard\fR | \fIeither\fR | \fInone\fR], \fB\-\-checksum\fR=[\fIstandard\fR | \fInonstandard\fR | \fIeither\fR | \fInone\fR]
+Choose FITS checksum mode or none. Defaults to standard.
+.TP
+\fB\-w\fR, \fB\-\-write\fR
+Write out file checksums and/or FITS compliance fixes.
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+Do file update even if original checksum was bad.
+.TP
+\fB\-c\fR, \fB\-\-compliance\fR
+Do FITS compliance checking, fix if possible.
+.TP
+\fB\-i\fR, \fB\-\-ignore\-missing\fR
+Ignore missing checksums.
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Generate extra output.
+.SH "EXAMPLES"
+.B "% fitscheck --checksum either --write *.fits"
+.br
+Verify and update checksums, tolerating non-standard checksums, updating to standard checksum.
+
+.B "% fitscheck --write --force *.fits"
+.br
+Write new checksums, even if existing checksums are bad or missing.
+
+.B "% fitscheck --compliance *.fits"
+.br
+Verify standard checksums and FITS compliance without changing the files.
+
+.B "% fitscheck --checksum nonstandard *.fits"
+.br
+Verify original nonstandard checksums only.
+
+.B "% fitscheck --checksum none --compliance --write *.fits"
+.br
+Only check and fix compliance problems, ignoring checksums.
+
+.B "% fitscheck *.fits"
+.br
+Verify standard interoperable checksums.
+
+.B "% fitscheck --checksum none --write *.fits"
+.br
+Delete checksum keywords.
+
diff --git a/debian/fitsdiff.1 b/debian/fitsdiff.1
new file mode 100644
index 0000000..51d9c4a
--- /dev/null
+++ b/debian/fitsdiff.1
@@ -0,0 +1,87 @@
+.TH fitsdiff 1 "April 2015" "fitsdiff" "astropy 1.0.2"
+.SH NAME
+fitsdiff \- compare two FITS image files and report the differences in header keywords and data.
+.SH SYNOPSIS
+.B fitsdiff
+[\fIOPTION\fR]... \fIFILE1\fR \fIFILE2\fR
+.SH DESCRIPTION
+.PP
+\fBfitsdiff\fR is a command line script based on pyfits to compare two
+FITS image files and report the differences in header keywords and data.
+.PP
+\fIFILE1\fR and \fIFILE2\fR are the two files to be compared. They may also be
+wild cards, in such cases, they must be enclosed by double or single quotes, or
+they may be directory names. If both are directory names, all files in each of
+the directories will be included; if only one is directory name, then the
+directory name will be prefixed to the file name(s) specified by the other
+argument. For example:
+.TP
+.B "% fitsdiff ""*.fits"" ""/machine/data1""
+.PP
+will compare all FITS files in the current directory to the corresponding files
+in the directory \fI/machine/data1\fR.
+.PP
+If the two files are identical within the specified conditions, it will report
+"No difference is found." If the value(s) of \fI-c\fR and \fI-k\fR takes the form
+\fI\@filename\fR, list is in the text file \fIfilename\fR, and each line in that text
+file contains one keyword.
+.PP
+\fBfitsdiff\fR commandline arguments can also be set using the environment variable
+\fIFITSDIFF_SETTINGS\fR. If the \fIFITSDIFF_SETTINGS\fR environment variable is present,
+each argument present will override the corresponding argument on the
+commandline. This environment variable exists to make it easier to change the
+behavior of \fBfitsdiff\fR on a global level, such as in a set of regression tests.
+.SH GENERIC OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Display terse usage information (help).
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Produce no output and just return a status code.
+.TP
+\fB\-n\fR \fIINTEGER\fR, \fB\-\-num\-diffs\fR=\fIINTEGER\fR
+Max number of data differences (image pixel or table element) to report per extension (default 10).
+.TP
+\fB\-d\fR \fINUMBER\fR, \fB\-\-difference-tolerance\fR=\fINUMBER\fR
+The relative tolerance for comparison of two numbers,
+specifically two floating point numbers. This applies
+to data in both images and tables, and to floating
+point keyword values in headers (default 0.0).
+.TP
+\fB\-b\fR, \fB\-\-no\-ignore\-blanks\fR
+Don't ignore trailing blanks (whitespace) in string
+values. Otherwise trailing blanks both in header
+keywords/values and in table column values) are not
+treated as significant i.e. without this option 'ABC ' and 'ABC' are considered equivalent.
+.TP
+\fB\-\-no\-ignore\-blank\-cards\fR
+Don't ignore entirely blank cards in headers. Normally \fIfitsdiff\fR does not
+consider blank cards when comparing headers, but this will ensure that even blank
+cards match up.
+.TP
+\fB\-o\fR \fIFILE\fR, \fB\-\-output\-file\fR=\fIFILE\fR
+Output results to this file; otherwise results are printed to stdout.
+.SH "HEADER COMPARISON OPTIONS"
+.TP
+\fB\-k\fR \fIKEYWORDS\fR, \fB\-\-ignore\-keywords\fR=\fIKEYWORDS\fR
+Comma-separated list of keywords not to be compared.
+Keywords may contain wildcard patterns. To exclude
+all keywords, use "*"; make sure to have double or
+single quotes around the asterisk.
+.TP
+\fB\-c\fR \fIKEYWORDS\fR, \fB\-\-ignore\-comments\fR=\fIKEYWORDS\fR
+Comma-separated list of keywords whose comments will not be compared.
+Wildcards may be used as with \fI\-\-ignore-keywords\fR.
+.SH "TABLE COMPARISON OPTIONS"
+.TP
+\fB\-f\fR \fICOLUMNS\fR, \fB\-\-ignore\-fields\fR=\fICOLUMNS\fR
+Comma-separated list of fields (i.e. columns) not to be compared.
+All columns may be excluded using "*" as with \fI\-\-ignore-keywords\fR.
+.SH "EXAMPLES"
+.B "% fitsdiff -k filename,filtnam1 -n 5 -d 1.e-6 test1.fits test2"
+.br
+This command will compare files \fItest1.fits\fR and \fItest2.fits\fR, report maximum of 5
+different pixels values per extension, only report data values larger than
+1.e-6 relative to each other, and will neglect the different values of
+keywords \fIFILENAME\fR and \fIFILTNAM1\fR (or their very existence).
+
diff --git a/debian/fitsheader.1 b/debian/fitsheader.1
new file mode 100644
index 0000000..4add989
--- /dev/null
+++ b/debian/fitsheader.1
@@ -0,0 +1,36 @@
+.TH FITSHEADER 1 "April 2015" "fitsheader" "astropy 1.0.2"
+.SH NAME
+fitsheader \- Print the header(s) of a FITS file.
+.SH DESCRIPTION
+usage: fitsheader [\-h] [\-e HDU] [\-k KEYWORD] [\-t [FORMAT]] [\-c]
+.IP
+filename [filename ...]
+.PP
+Print the header(s) of a FITS file. Optional arguments allow the desired
+extension(s), keyword(s), and output format to be specified. Note that in the
+case of a compressed image, the decompressed header is shown by default.
+.SS "positional arguments:"
+.TP
+filename
+path to one or more files; wildcards are supported
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-e\fR HDU, \fB\-\-extension\fR HDU
+specify the extension by name or number; this argument
+can be repeated to select multiple extensions
+.TP
+\fB\-k\fR KEYWORD, \fB\-\-keyword\fR KEYWORD
+specify a keyword; this argument can be repeated to
+select multiple keywords; also supports wildcards
+.TP
+\fB\-t\fR [FORMAT], \fB\-\-table\fR [FORMAT]
+print the header(s) in machine\-readable table format;
+the default format is "ascii.fixed_width" (can be
+"ascii.csv", "ascii.html", "ascii.latex", "fits", etc)
+.TP
+\fB\-c\fR, \fB\-\-compressed\fR
+for compressed image data, show the true header which
+describes the compression rather than the data
diff --git a/debian/samp_hub.1 b/debian/samp_hub.1
new file mode 100644
index 0000000..7938881
--- /dev/null
+++ b/debian/samp_hub.1
@@ -0,0 +1,130 @@
+.TH SAMP_HUB 1 "April 2015" "samp_hub" "astropy 1.0.2"
+.SH NAME
+samp_hub \- SAMP Hub Server
+.SH DESCRIPTION
+usage: samp_hub [\-h] [\-k CODE] [\-d ADDR] [\-p PORT] [\-f FILE] [\-w]
+.TP
+[\-P SIZE] [\-t SECONDS] [\-c SECONDS] [\-L LEVEL] [\-O FILE]
+[\-l LABEL] [\-m] [\-s] [\-C FILE] [\-K FILE]
+[\-\-cert\-reqs STRING] [\-\-ca\-certs FILE]
+[\-\-ssl\-version STRING]
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-k\fR CODE, \fB\-\-secret\fR CODE
+custom secret code.
+.TP
+\fB\-d\fR ADDR, \fB\-\-addr\fR ADDR
+listening address (or IP).
+.TP
+\fB\-p\fR PORT, \fB\-\-port\fR PORT
+listening port number.
+.TP
+\fB\-f\fR FILE, \fB\-\-lockfile\fR FILE
+custom lockfile.
+.TP
+\fB\-w\fR, \fB\-\-no\-web\-profile\fR
+run the Hub disabling the Web Profile.
+.TP
+\fB\-P\fR SIZE, \fB\-\-pool\-size\fR SIZE
+the socket connections pool size.
+.SS "Timeout group:"
+.IP
+Special options to setup hub and client timeouts.It contains a set of
+special options that allows one to set up the Hub and clients inactivity
+timeouts, that is the Hub or client inactivity time interval after which
+the Hub shuts down or unregisters the client. Notification of
+samp.hub.disconnect MType is sent to the clients forcibly unregistered for
+timeout expiration.
+.TP
+\fB\-t\fR SECONDS, \fB\-\-timeout\fR SECONDS
+set the Hub inactivity timeout in SECONDS. By default
+it is set to 0, that is the Hub never expires.
+.TP
+\fB\-c\fR SECONDS, \fB\-\-client\-timeout\fR SECONDS
+set the client inactivity timeout in SECONDS. By
+default it is set to 0, that is the client never
+expires.
+.SS "Logging options:"
+.IP
+Additional options which allow one to customize the logging output. By default
+the SAMP Hub uses the standard output and standard error devices to print
+out INFO level logging messages. Using the options here below it is
+possible to modify the logging level and also specify the output files
+where redirect the logging messages.
+.TP
+\fB\-L\fR LEVEL, \fB\-\-log\-level\fR LEVEL
+set the Hub instance log level (OFF, ERROR, WARNING,
+INFO, DEBUG).
+.TP
+\fB\-O\fR FILE, \fB\-\-log\-output\fR FILE
+set the output file for the log messages.
+.SS "Advanced group:"
+.IP
+Advanced options addressed to facilitate administrative tasks and allow
+new non\-standard Hub behaviors. In particular the \fB\-\-label\fR options is used
+to assign a value to hub.label token and is used to assign a name to the
+Hub instance. The very special \fB\-\-multi\fR option allows one to start a Hub in
+multi\-instance mode. Multi\-instance mode is a non\-standard Hub behavior
+that enables multiple contemporaneous running Hubs. Multi\-instance hubs
+place their non\-standard lock\-files within the <home directory>/.samp\-1
+directory naming them making use of the format: samp\-hub\-<PID>\-<ID>, where
+PID is the Hub process ID while ID is an internal ID (integer).
+.TP
+\fB\-l\fR LABEL, \fB\-\-label\fR LABEL
+assign a LABEL to the Hub.
+.TP
+\fB\-m\fR, \fB\-\-multi\fR
+run the Hub in multi\-instance mode generating a custom
+lockfile with a random name.
+.SS "SSL group:"
+.IP
+Additional options to launch the Hub instance using the Secure Sockets
+Layer (HTTPS). The \fB\-\-key\-file\fR and \fB\-\-cert\-file\fR parameters specify optional
+files which contain a certificate to be used to identify the local side of
+the connection. Often the private key is stored in the same file as the
+certificate; in this case, only the \fB\-\-cert\-file\fR parameter need be passed.
+If the private key is stored in a separate file, both parameters must be
+used. If the private key is stored in the certificate file, it should come
+before the first certificate in the certificate chain.
+.TP
+\fB\-s\fR, \fB\-\-https\fR
+run the Hub using the Secure Sockets Layer.
+.TP
+\fB\-C\fR FILE, \fB\-\-cert\-file\fR FILE
+set the certificate file.
+.TP
+\fB\-K\fR FILE, \fB\-\-key\-file\fR FILE
+set the key file. By default this option is ignored,
+assuming that the private key is stored in the
+certificate file.
+.TP
+\fB\-\-cert\-reqs\fR STRING
+this option specifies whether a certificate is
+required from the client side of the connection, and
+whether it will be validated if provided. It must be
+one of the three values NONE (certificates ignored,
+default), OPTIONAL (not required, but validated if
+provided), or REQUIRED (required and validated). If
+the value of this option is not NONE, then the \fB\-\-cacerts\fR option must point to a file of CA certificates.
+.TP
+\fB\-\-ca\-certs\fR FILE
+the \fB\-\-ca\-certs\fR file contains a set of concatenated
+"certification authority" certificates, which are used
+to validate certificates passed from the client end of
+the connection.
+.TP
+\fB\-\-ssl\-version\fR STRING
+the \fB\-\-ssl\-version\fR option specifies which version of
+the SSL protocol to use. Typically, the server chooses
+a particular protocol version, and the client must
+adapt to the server's choice. Most of the versions are
+not interoperable with the other versions. If not
+specified the default SSL version is taken from the
+default in the Python standard `ssl` library for the
+version of Python that is installed. Other SSL
+protocol versions are: SSLv2, SSLv3, SSLv23, TLSv1,
+TLSv1_1, TLSv1_2 but not all of them may be available
+on all versions of Python.
diff --git a/debian/volint.1 b/debian/volint.1
new file mode 100644
index 0000000..4f2cf54
--- /dev/null
+++ b/debian/volint.1
@@ -0,0 +1,13 @@
+.TH VOLINT 1 "April 2015" "volint" "astropy 1.0.2"
+.SH NAME
+volint \- Check a VOTable file for compliance to the VOTable specification
+.SH DESCRIPTION
+usage: volint [\-h] filename
+.SS "positional arguments:"
+.TP
+filename
+Path to VOTable file to check
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
diff --git a/debian/wcslint.1 b/debian/wcslint.1
new file mode 100644
index 0000000..c715ff8
--- /dev/null
+++ b/debian/wcslint.1
@@ -0,0 +1,13 @@
+.TH WCSLINT 1 "April 2015" "wcslint" "astropy 1.0.2"
+.SH NAME
+wcslint \- Check the WCS keywords in a FITS file for compliance against the standards
+.SH DESCRIPTION
+usage: wcslint [\-h] filename
+.SS "positional arguments:"
+.TP
+filename
+Path to FITS file to check
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-astro/packages/python-astropy.git
More information about the debian-science-commits
mailing list