Contents

• Contents
• 1. Summary of All Functions
• 2. Using `idx' Sorting Numbers
  • 2.1 What are `idx' numbers?
  • 2.2 Reserved Keywords
  • 2.3 Auto-assigned `idx' Numbers
• 3. Opening, Locking, Closing and Creating FITS files
  • 3.1 fh_create()
  • 3.2 fh_copy_hu()
  • 3.3 fh_destroy()
  • 3.4 fh_read()
  • 3.5 fh_file()
  • 3.6 fh_reindex()
  • 3.7 fh_file_desc()
  • 3.8 fh_reserve()
  • 3.9 fh_write()
  • 3.10 fh_write_padding()
  • 3.11 fh_write_padded_image()
  • 3.12 fh_read_padded_image()
  • 3.13 fh_copy_padded_image()
  • 3.14 fh_rewrite()
• 4. Examining Extensions and Image Data
  • 4.1 fh_extensions()
  • 4.2 fh_image_bytes()
  • 4.3 fh_image_blocks()
  • 4.4 fh_header_blocks()
  • 4.5 fh_ehu()
  • 4.6 fh_ehu_by_imageid()
  • 4.7 fh_ehu_by_extname()
• 5. Looking at Keywords
  • 5.1 fh_get_bool()
  • 5.2 fh_get_int()
  • 5.3 fh_get_flt()
  • 5.4 fh_get_str()
  • 5.5 fh_first() and fh_next()
  • 5.6 fh_idx()
  • 5.7 fh_search()
  • 5.8 fh_show()
  • 5.9 fh_idx_before() and fh_idx_after()
• 6. Changing Keywords
  • 6.1 fh_remove()
  • 6.2 fh_set_all_units()
  • 6.3 fh_set_com()
  • 6.4 fh_set_bool()
  • 6.5 fh_set_int()
  • 6.6 fh_set_flt()
  • 6.7 fh_set_str()
  • 6.8 fh_set_val()
  • 6.9 fh_merge()
• 7. Redirecting Error Messages
  • 7.1 fh_log_warning()
  • 7.2 fh_log_error()
  • 7.3 fh_log_perror()
• 8. Including and Linking the Library
• 9. Recipes for Converting to libfh
  • 9.1 Opening a File
  • 9.2 Changing Keywords
  • 9.3 ``Flushing'' Changes to a File
  • 9.4 Closing a File
• 10. Examples
  • 10.1 Display any Primary or Extension Header (fhlist.c)
  • 10.2 Loop through all extensions by EXTNAME (fhextname.c)
  • 10.3 Tool to Set any Keyword(s) (fhset.c)
  • 10.4 Tool for making Reserve Space (fhreserve.c)
  • 10.5 Update a Card with known Keyword
  • 10.6 Add set of COMMENT cards to already open file
  • 10.7 Build a FITS File from Scratch
  • 10.8 Build an MEF File from Scratch