summaryrefslogtreecommitdiffstats
path: root/fitsy/doc/headins.html
blob: 311f34379b2fdb7bac233ec054f2c7e8f48112b8 (plain)
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE> headins
</TITLE>
<p>
<!-- pnuts --> <a href="headfind.html">[Previous]</a> <a href="headdata.html">[Next]</a> <a href="fitsy.html">[Up]</a> <a href="../mmtilib.html">[Top]</a>
<META NAME="generator" CONTENT="txt2html v1.3">
</HEAD>
<BODY>


<A NAME="section-1.1.1"><H3>NAME</H3></A>

<P>
 ft_headinsl,ft_headinsi,ft_headinsr,ft_headinss,ft_headinsv,ft_headappl,ft_headappi,ft_headappr,ft_headapps,ft_headappv,ft_headdel
- Routines to insert, append and delete FITS cards from a header.

<A NAME="section-1.1.2"><H3>SYNOPSIS</H3></A>

 

<PRE>
FITSCard ft_headinsl(FITSHead fits, char *name, int n, int lvalue, char *comm, FITSCard here);
FITSCard ft_headinsi(FITSHead fits, char *name, int n, int ivalue, char *comm, FITSCard here);
FITSCard ft_headinsr(FITSHead fits, char *name, int n, double dvalue, int prec, char *comm, FITSCard here);
FITSCard ft_headinss(FITSHead fits, char *name, int n, char *svalue, char *comm, FITSCard here);
FITSCard ft_headinsv(FITSHead fits, char *name, int n, char *vvalue, char *comm, FITSCard here);
FITSCard ft_headappl(FITSHead fits, char *name, int n, int lvalue, char *comm);
FITSCard ft_headappi(FITSHead fits, char *name, int n, int ivalue, char *comm);
FITSCard ft_headappr(FITSHead fits, char *name, int n, double dvalue, int prec, char *comm);
FITSCard ft_headapps(FITSHead fits, char *name, int n, char *svalue, char *comm);
FITSCard ft_headappv(FITSHead fits, char *name, int n, char *vvalue, char *comm);
FITSCard ft_headdel(FITSHead fits, char *name, int n);


<P>
</PRE>
<A NAME="section-1.1.3"><H3>PARAMETERS</H3></A>

<UL>
<P>
  <LI> <B>FITSHead fits</B> - FITS header to insert, append or
      delete a card.
  <LI> <B>char *name</B> - Name of the FITS card.
  <LI> <B>int n</B> - keyword index number, if is zero no
      index number is appended to the
      keyword.
  <LI> <B>int lvalue</B> - Logical to format as a FITS value.
  <LI> <B>char *comm</B> - Comment for the new card.
  <LI> <B>FITSCard here</B> - Insert the new card after this card.
  <LI> <B>int ivalue</B> - Integer to format as a FITS value.
  <LI> <B>double dvalue</B> - Double to format as a FITS value.
  <LI> <B>int prec</B> - Precision for the value
  <LI> <B>char *svalue</B> - String to format as a FITS value
  <LI> <B>char *vvalue</B> - Raw value to format as a FITS value

</UL>
<A NAME="section-1.1.4"><H3>DESCRIPTION</H3></A>

<P>
 These routines allow FITS cards to be inserted, appended and deleted
 by keyword value.
 
<P>
 The insertion routines format a new card with the supplied keyword and
 value and insert it after indicated card. The append routines add new
 cards to the end of the header (before the END card).

<A NAME="section-1.1.4.1"><H4>ft_headinsl</H4></A>

<P>
 Insert a logical value FITS card into a header.

<A NAME="section-1.1.4.2"><H4>ft_headinsi</H4></A>

<P>
 Insert a integer value FITS card into a header.

<A NAME="section-1.1.4.3"><H4>ft_headinsr</H4></A>

<P>
 Insert a real value FITS card into a header.

<A NAME="section-1.1.4.4"><H4>ft_headinss</H4></A>

<P>
 Insert a string value FITS card into a header.

<A NAME="section-1.1.4.5"><H4>ft_headinsv</H4></A>

<P>
 Insert a raw value FITS card into a header.

<A NAME="section-1.1.4.6"><H4>ft_headappl</H4></A>

<P>
 Append a logical value FITS card to a header.

<A NAME="section-1.1.4.7"><H4>ft_headappi</H4></A>

<P>
 Append a integer value FITS card to a header.

<A NAME="section-1.1.4.8"><H4>ft_headappr</H4></A>

<P>
 Append a real value FITS card to a header.

<A NAME="section-1.1.4.9"><H4>ft_headapps</H4></A>

<P>
 Append a string value FITS card to a header.

<A NAME="section-1.1.4.10"><H4>ft_headappv</H4></A>

<P>
 Append a raw value FITS card to a header.

<A NAME="section-1.1.4.11"><H4>ft_headdel</H4></A>

<P>
 Find and delete a card from a FITS header.

<p>
<!-- pnuts --> <a href="headfind.html">[Previous]</a> <a href="headdata.html">[Next]</a> <a href="fitsy.html">[Up]</a> <a href="../mmtilib.html">[Top]</a>
</BODY>
</HTML>