# Requires core IRAF:  http://www.iraf.net
#
# ORIG_NAME -- rename a list of images from the NOAO Science Archive,
# restoring names from DTACQNAM (by default)
#
# Where: DTACQNAM is file name supplied at telescope
#
# To install:
#
# Save this file into "orig_name.cl" in a convenient directory.
#
# Then type (or include this command in your login.cl file):
#
#    cl> task orig_name = <directory>/orig_name.cl
#
# usage per parameters, typically:
#
#    cl> orig_name *.fits
#
# to rename files with a suffix added if there are any name collisions
# (e.g., testa.fits, testb.fits, testc.fits).  Files can be copied instead
# of renamed.  A prefix allows renaming or copying into a subdirectory,
# for instance, prefix="old/".  Create the directory before running the task.
# Files resulting from name collisions can also be overwritten or skipped.
#
# Output is always written to the current directory.
#
# To restore the archive names:
#
#    cl> orig_name *.fits keyword=sb_name
#
# R. Seaman <seaman@noao.edu>
# NOAO Data Products Program
# 30 April 2008