File: fitspng.1

package info (click to toggle)
fitspng 1.4-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 1,804 kB
  • sloc: sh: 1,232; ansic: 860; makefile: 14
file content (111 lines) | stat: -rw-r--r-- 3,909 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
.TH FITSPNG 1 "January 2019" "Fitspng" "User Commands"
.SH NAME
fitspng \- FITS to PNG converter.
.SH SYNOPSIS
.B fitspng
.I [options] file(s)
.SH DESCRIPTION
Fitspng is an utility intended to convert of images in astronomical FITS
format to computer graphics PNG format.
.PP
The primary goal of fitspng is to transform of the high dynamic images to a limited numerical range of PNG format. The transformation uses global tone mapping by a set of tone functions with machine estimated or user provided scaling parameters.
.PP
The detailed description can be found at homepage: http://integral.physics.muni.cz/fitspng
.SH OPTIONS
.TP
.B \-f [linear|asinh|log|gamma|normal|sqrt|sqr|logistic|atan]
Scale output intensities by specified profile: linearly, asinh, log,
gamma (as in sRGB), normal (Gauss cumulative distribution function [5]),
square root, square, logistic (emulating classical photography
sensitivity [6]), atan and ratio (x/1+x).
.TP
.B \-f0 f
Specifies scale of output profile: f*Func(i).
.TP
.B \-fz z
Specifies zero (black level) of output profile: Func(i) + z.
.TP
.B \-fr u,v
Output intensities, in case of colour depth 8 bites, are scaled
according this formula: (output intensities) = Func((input intensities \-
(med \- u*mad))/(mad/v)) where med is median of every 10 pixel
in the image, mad is mean of positive deviations from the median of every
10 pixel (same frequency). If the pixel is out of level range from
0 to 255, than value is replaced by 0 and 255 respectively.
The default is u = 3, v = 1/3.
.TP
.B \-fl t,s
Output intensities, in case of colour depth 8 bites, are scaled
according this formula: (output intensities) = Func((input intensities \- t)/s).
The setup completely disable internal parameter estimation.
.TP
.B \-fs x
The colour saturation is multiplied by the given ratio (for colour FITS only).
.TP
.B \-fw x,y
Set coordinates of white point.
.TP
.B \-fn st,ss
When used, switch-on mode which emulates humans night vision. It is useful
only for colour FITS.
.TP
.B \-cs sRGB or AdobeRGB
Select the colour-space of output image.
.TP
.B \-s s
Shrink image: scale down the size of image by the specified factor s as
a (non-zero) positive integer number. If the s factor is greater of one,
any output pixel is constructed as arithmetic mean of s*s input pixels.
.TP
.B \-o
Specify an output file name, valid only if a single file is passed.

If this switch is omitted, the output filename is determined by
modification of input filenames: suffixes, like *.fits, are replaced by *.png,
and the directory path is removed. The approach leaves original data untouched,
results are stored in current working directory.
.TP
.B \-B [8|16]
8 bites per pixel of colour (gray) depth of output. This is default.
16 bites per pixel of colour (gray) depth of output. There is frequently
problem with additional rendering. Most of utilities doesn't work with this
colour depth correctly. On the other side, 16 bit per pixel images
has saved photometric content more precisely.
.TP
.B \-v
Print additional info during processing.
.TP
.B \-\-help
Show summary of options.
.TP
.B \-\-version
Display software version.
.SH EXAMPLES
Convert an image from FITS to PNG:
    $ fitspng \-o gray.png gray.fits
.PP
Emulate human's night vision:
    $ fitspng \-fn 100,10 \-o scotopic.png  colour.fits
.PP
Emulate classical photography sensitivity function (density curve):
    $ fitspng \-f logistic \-o photo.png colour.fits
.PP
Create semi-gray image:
    $ fitspng \-fs 0.2 \-o reduced.png colour.fits
.PP
Select the specified band from colour FITS (with help of FITS file name
extension):
    $ fitspng \-o green.png "colour.fits[1]"
.PP
Create thumbnails:
    $ fitspng -s 10 *.fits
.SH AUTHOR
Filip Hroch <hroch@physics.muni.cz>
.SH SEE ALSO
rawtran(1)
.P
[1] http://integral.physics.muni.cz/fitspng
.P
[2] http://munipack.physics.muni.cz/
.P
[3] http://integral.physics.muni.cz/rawtran