funimage - 云端在线

程序：

您的姓名

funimage - 从 Funtools 数据文件创建一个 FITS 图像

概要

有趣的形象 [-一种] [位像素=n] 有趣的形象 [-l]
[位像素=n] 有趣的形象 [-px 关注] [位像素=n]

配置

-a # 附加到现有输出文件作为图像扩展名
-l #输入是一个包含xcol、ycol、value的列表文件
-p [x y] # 沿 x 或 y 轴投影以创建一维图像

商品描述

有趣的形象 从指定的 FITS 扩展和/或图像创建主 FITS 图像
FITS 文件的一部分，或来自非 FITS 阵列的图像部分，或来自原始事件
文件中。

程序的第一个参数指定 FITS 输入图像、数组或原始事件文件
处理。 如果指定了“stdin”，则从标准输入读取数据。 使用 Funtools
用于指定 FITS 扩展、图像部分和过滤器的括号表示法。 第二
参数是输出 FITS 文件。 如果指定了“stdout”，则将 FITS 图像写入
标准输出。 默认情况下，输出像素值的数据类型与
输入文件的那些（或在合并表时键入“int”），但这可以被覆盖
使用以下形式的可选第三个参数：

位像素=n

其中 n 为 8,16,32、32、64、-XNUMX、-XNUMX，分别表示 unsigned char、short、int、float 和 double。

如果输入数据是图像类型，则提取并阻止适当的部分
（基于 Image Section 的指定方式），并将结果写入 FITS
主要形象。 当包含 BSCALE 和 BZERO 关键字的整数图像是
转换为浮点数，像素值被缩放，缩放关键字从
输出头。 将整数缩放数据转换为整数（可能是不同的
size），像素不缩放，保留缩放关键字。

如果输入数据是二进制表或原始事件文件，则将它们合并到图像中，
从中提取和阻止部分，并写入主要 FITS 图像。 在
在这种情况下，有必要指定将在 2D 分箱中使用的两列。
这可以在命令行上使用 bincols=(x,y) 关键词：

funcnts "foo.ev[EVENTS,bincols=(detx,dety)]"

的完整形式 二进制= 说明符是：

bincols=([xname[:tlmin[:tlmax:[binsiz]]]],[yname[:tlmin[:tlmax[:binsiz]]]])

其中 tlmin、tlmax 和 binsiz 说明符确定图像合并维度：

dim = (tlmax - tlmin)/binsiz（浮点数据）
暗淡 = (tlmax - tlmin)/binsiz + 1（整数数据）

使用这种语法，可以将二进制表的任意两列分箱到任意分箱
尺寸。 请注意，如果 TLMIN、TLMAX、
和 TDBIN 头参数（分别）存在于 FITS 二进制表头中，用于
有问题的列。 另请注意，如果仅指定了一个参数，则假定
为 tlmax，tlmin 默认为 1。如果指定了两个参数，则假定它们为
是 tlmin 和 tlmax。 有关更多信息，请参阅分箱 FITS 二进制表和非 FITS 事件文件
关于分箱参数的信息。

默认情况下，会创建一个新的 2D FITS 图像文件并将图像写入主
HDU。 如果 -a (append) 开关被指定，图像被附加到一个现有的 FITS
文件作为 IMAGE 扩展名。 （如果输出文件不存在，则开关有效
忽略并将图像写入主 HDU。）这在 shell 中很有用
处理要组合成的多个 FITS 图像时的编程环境
一个最终的 FITS 文件。

有趣的形象 也可以从包含 x、y 和值列的表中获取输入（例如，
来自的输出 基金管理公司 -l 它显示每个图像 x 和 y 以及计数的数量
位置。）当 -l (list) 开关被使用，输入文件被认为是一个 FITS 或
包含（至少）三列指定 x 和 y 图像坐标的 ASCII 表
以及该图像像素的值。 在这种情况下， 有趣的形象 需要四个额外的参数：
xcolumn:xdims、ycolumn:ydims、vcolumn 和 bitpix=n。 x 和 y col:dim 信息需要
表格：

name:dim # 值范围从 1 到暗淡
name:min:max # 值范围从最小值到最大值
name:min:max:binsiz # 按 binsize 缩放的维度

特别是，当最小坐标值是
不同于一个的东西。 例如：

funimage -l foo.lst foo.fits xcol:0:512 ycol:0:512 值 bitpix=-32

列表功能还可用于从标准输入读取未命名的列：
用空字符串替换列名。 注意维度信息还是
需要：

funimage -l stdin foo.fits "":0:512 "":0:512 "" bitpix=-32
240 250 1
255 256 2
...
^D

列表功能提供了一种生成空白图像的简单方法。 如果你通过一列 -
基于文本文件到 funimage，其中文本标题包含所需的图像
信息，然后 funimage 将正确地制作一个空白图像。 例如，考虑
以下文本文件（称为 foo.txt）：

x:我:1:10 y:我:1:10
------ ------
0 0

该文本文件定义了两列 x 和 y，每列的数据类型为 32 位 int 和 image
维度 10. 命令：

funimage foo.txt foo.fits bitpix=8

将创建一个名为 foo.fits 的空 FITS 图像，其中包含一个 10x10 的 unsigned char 图像：

Fundisp foo.fits
1 2 3 4 5 6 7 8 9 10
————————————————————————————————————————————— ---- ------
10：0 0 0 0 0 0 0 0 0 0
9：0 0 0 0 0 0 0 0 0 0
8：0 0 0 0 0 0 0 0 0 0
7：0 0 0 0 0 0 0 0 0 0
6：0 0 0 0 0 0 0 0 0 0
5：0 0 0 0 0 0 0 0 0 0
4：0 0 0 0 0 0 0 0 0 0
3：0 0 0 0 0 0 0 0 0 0
2：0 0 0 0 0 0 0 0 0 0
1：1 0 0 0 0 0 0 0 0 0

请注意，文本文件必须至少包含一行数据。 然而，在目前
例如，事件位置 0,0 超出图像的限制，将被忽略。 （你
当然，可以使用真实的 x,y 值来为图像播种数据。）

此外，您可以使用 TEXT 过滤器规范来避免输入
整个文本文件。 以下命令将创建相同的 10x10 字符图像，而无需
一个实际的输入文件：

funimage stdin'[TEXT(x:I:10,y:I:10)]' foo.fits bitpix=8 < /dev/null
or
funimage /dev/null'[TEXT(x:I:10,y:I:10)]' foo.fits bitpix=8

您也可以使用这些方法中的任何一种来生成区域掩码，只需添加一个
过滤器括号内的区域并指定 面具=全部 随着位像素。 为了
例如，以下命令将使用 10 个区域生成 10x3 字符掩码：

funimage stdin'[TEXT(x:I:10,y:I:10),cir(5,5,4),point(10,1),-cir(5,5,2)]' \
foo.fits bitpix=8,mask=all < /dev/null

生成的掩码如下所示：

Fundisp foo.fits
1 2 3 4 5 6 7 8 9 10
————————————————————————————————————————————— ---- ------
10：0 0 0 0 0 0 0 0 0 0
9：0 0 0 0 0 0 0 0 0 0
8：0 0 1 1 1 1 1 0 0 0
7：0 1 1 1 1 1 1 1 0 0
6：0 1 1 0 0 0 1 1 0 0
5：0 1 1 0 0 0 1 1 0 0
4：0 1 1 0 0 0 1 1 0 0
3：0 1 1 1 1 1 1 1 0 0
2：0 0 1 1 1 1 1 0 0 0
1：0 0 0 0 0 0 0 0 0 2

您可以使用 有趣的形象 沿 x 或 y 轴创建一维图像投影 -p
[x习惯] 转变。 此功能适用于图像和表格。 例如考虑一个
名为 ev.fits 的 FITS 表包含以下行：

XY
—————————
1 1
1 2
1 3
1 4
1 5
2 2
2 3
2 4
2 5
3 3
3 4
3 5
4 4
4 5
5 5

因此，称为dim5.fits 的相应5x2 图像将包含：

1 2 3 4 5
---------- ---------- ---------- ---------- ----------
5：1 1 1 1 1
4：1 1 1 1 0
3：1 1 1 0 0
2：1 1 0 0 0
1：1 0 0 0 0

可以在表格或图像上执行沿 y 轴的投影：

funimage -py ev.fits stdout 获得fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1：1 2 3 4 5

funimage -py dim2.fits stdout 获得fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1：1 2 3 4 5

此外，您可以使用
bincols=[列] 过滤器规范并指定单个列。 例如，
以下命令沿表格的 y 轴投影相同的 1D 图像作为使用 -p
y 开关：

funimage ev.fits'[bincols=y]' stdout 获得fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1：1 2 3 4 5

例子：

从 FITS 二进制表创建 FITS 图像：

[sh] funimage test.ev 测试.fits

显示从 FITS 二进制表的阻塞部分生成的 FITS 图像：

[sh] funimage "test.ev[2:8,3:7,2]" stdout 获得fundisp stdin
1 2 3
---------- ---------- ----------
1：20
2：28

使用 onworks.net 服务在线使用 funimage