# File: grating2_hrc.exp
# Specifies calibration tests of the gratings in combination with the HRC.
# Most of these tests were discussed in a meeting of the Grating group
#   in Huntsville on 11/15.

# Setup
CLEAR

# Assign defaults to most parameters
INCLUDE default2_hrc.include
DEFAULT

# Set a few parameters that won't change from test to test
#name	MIT/ASC HLM
sequence	2A
priority	10

# Suite 1
# ___________________________________________________________________________
# Focus check with gratings.
# We rely on the HRC team to determine the focus of the HRC-I and the
#   HRC-S for imaging purposes.  When the gratings are used, the focus
#   should be the same, so the purpose is to verify that this is the
#   case.
# With one image, we can see out to very high orders.  The objective
#   is to check the focus at 0th order as well as at modest dispersion,
#   say +/-5 in LETG, +/- 3 in MEG and +/- 2 in HEG.
# Total counts are for the 0th order but we also want high orders, so
#   about 10x more counts are planned for 0th order than needed.
# We get enough counts in 1st order that the suite provides a good PSF
#   as well.
# ___________________________________________________________________________
type		Focus Check
source		EIPS
target		Mg-Ka
# small spot requested to improve size of PSF.
spot_size	SMALL


# KAF Focused beam cannot take more than 5/sec or get gain suppression.
fam_dither_type	grat1
max_fp_rate	5
name LE/Herman Marshall
grating		LETG
shutter		ALL,SCAN
detector	HRC,S

# Plan for 1000 counts in 5th order
min_fp_counts	25000
GO

SAMESUITE
name HE/Herman Marshall
grating		HETG
detector	HRC,I
# Plan for 1000 counts in 3th order
min_fp_counts	9000
GO

DEFAULT

# Suite 2
# ___________________________________________________________________________
# Penning PSF Series
# First use of Penning requires a focus check sequence.
# All off-nominal tests require 20000 cnt, so this one should obtain
#   that many as well and create the nominal focus PSF.
# ___________________________________________________________________________
type		Focus Check
grating		LETG
shutter		ALL,SCAN

# KAF Focused beam cannot take more than 5/sec or get gain suppression.
# However, it seems Penning will not use "max_fp_rate". Must watch on
# floor. Also, will get many orders, with 221 eV detected 3 times more
# than 95 eV.

INCLUDE	penning.include
energy	0.0954
name LE/Herman Marshall
grating	LETG

# counts requested are per shutter exposure in 0th order.
# The count rate calculation is not working yet, so set integ. time.
# Basing integration times on 30 cnt/s when all shutters are open.

fam_dither_type grat1
detector	HRC,S
min_fp_counts	5000
integ_time	3200
atomic_time_list	800
multiplicity	4
GO

# Suite 3
# ___________________________________________________________________________
# Let's take one set of defocus PSFs
# Use the same set of defocus positions as in Phase 1.
# The count rate calculation is not working yet, so set integ. time.
# Basing integration times on 30 cnt/s when all shutters are open.
# KAF Penning will not "take" and use max_fp_rate.
# ___________________________________________________________________________

# KAF Since the Penning source dies quickly, it would be nice
# to focus the Penning source in real time. If dither is not
# required, use fam_dither_type FIXED.


#fam_dither_type	FIXED
fam_dither_type	grat1
sequence	2B
shutter		ALL,ALL
defocus		-1.0; -0.5; 0.5; 1.0; 2.0
min_fp_counts	15000
integ_time	500
atomic_time_list	500
multiplicity	1
GO

# Suite 4
# ___________________________________________________________________________
# Finally, take a few off-axis.
# Use the same set of off-axis angles as in Phase 1.
# KAF - It is possible these count rates can be higher than 5/sec
# because the image is defocused. I will put in a fam dither just in case
# and we can leave it out at the last minute.
# ___________________________________________________________________________

fam_dither_type grat1
defocus		0
hrma_az		0; 45; 90; 0
hrma_polar	1;1.0;  3; 8.33
CORRELATE	hrma_az hrma_polar
GO
 
DEFAULT
UNCORRELATE

# Suite 5
# ___________________________________________________________________________
# EA suites
# This series involves EIPS anodes, in contrast with DCM scans.
# Defocus in order to reduce the count rate per pore to a level
#   of about 5 count/s/beam size.  Defocus needs to expand the
#   beam by a factor of 10, roughly, so that we can get 50 count/s.
#   2 mm defocus gives a beam size of 250 microns, which is 5 times
#   the nominal HRMA beam size of 50 micron.
# ___________________________________________________________________________
type	Effective Area
source	EIPS		
name LE/Herman Marshall
grating			LETG
shutter			ALL,ALL
order			+1
check_order		0
# LETG objective is 100,000 counts so that the 30th order or so still
#   gives us 100 counts.
# KAF - changed from 100,000 ctns to 10,000 cnts
min_fp_counts	10000
detector		HRC,S
defocus		2
flux_line_all	ALL


# We need to correlate the max_fp_rate with the anode.
# T/M limit is about 180 count/s but we need to limit the total
#   count rate to of order 150 count/s to reduce the problems of
#   the bandwidth.  This limit must not be exceeded by the *SUM*
#   of *ALL* orders that are expected, both plus and minus, and zero.
# Filters may help eliminate unwanted continuum.
# KAF - up to 1 kev for LEG, assume 25 cnts/sec +1 and -1,
# and 50 cnts/sec for 0th. For resonance peak, allow specific numbers;
# Above 2 keV to 4.5 keV, 25 for 1st, 30 for 0th. These limits
# will keep the total telemetry rate down to about 100 to 
# 120/sec (we hope). Separate out the high energy lines.
# Setting the max_fp_rate is to set the largest of these values.
# 

# LOW ENERGIES (UP TO 1 keV)
sequence	2A
CORRELATE	target	max_fp_rate
max_fp_rate	50; 50; 50; 50; 50; 50; 50; 50
target		Be-Ka; B-Ka; C-Ka; Ti-La; O-Ka; Fe-La; Ni-La; Cu-La 
GO

# RESONANCE PEAK
SAMESUITE
sequence	2B
CORRELATE	target	max_fp_rate
max_fp_rate	30; 35; 40
target		Mg-Ka; Al-Ka; Si-Ka 
GO

#MEDIUM ENERGIES
SAMESUITE
sequence	2B
max_fp_rate	 30;  30; 30; 30
target		 Sn-La;  Zr-La; Mo-La; Ag-La
GO

#HIGH ENERGIES
SAMESUITE
sequence	2C
max_fp_rate	50; 50; 50
target		Ti-Ka; Fe-Ka; Cu-Ka 
GO


# KAF - Resultant count rates seem high, but we have flux_line_all = ALL.
# To set integration times, I need to run it once with it set to LINE.


# Suite 6
# ___________________________________________________________________________
# HETG objective is about 30,000 counts because fewer orders will
#   be involved. KAF - HRC will not flat field to better than 3%
#  so can choose 10,000 counts instead.
# ___________________________________________________________________________
name HE/Herman Marshall
grating			HETG
#min_fp_counts	30000
min_fp_counts	10000
detector		HRC,I

sequence	2A
CORRELATE	target	max_fp_rate
target		O-Ka; Fe-La; Mg-Ka; Al-Ka; Si-Ka

shutter			MEG,ALL
max_fp_rate	30; 40; 30; 35; 40
GO

# Can't reach 1st order Fe-La, O-Ka with HEG on HRC-I
# RESONANCE PEAK
SAMESUITE
target		Mg-Ka; Al-Ka; Si-Ka
shutter			HEG,ALL
max_fp_rate	30; 35; 40
GO

SAMESUITE
# HIGH ENERGY LINES
sequence	2B
target		Ti-Ka; Fe-Ka; Cu-Ka
shutter		MEG,ALL
max_fp_rate	50; 50; 50
GO

SAMESUITE
shutter		HEG,ALL
max_fp_rate	50; 50; 50
GO

SAMESUITE
sequence	2C
target		Ti-La; Ni-La; Cu-La; Zr-La; Mo-La; Ag-La; Sn-La
shutter		MEG,ALL
max_fp_rate	45; 30; 40; 30; 30; 30; 30
GO

# Can't reach 1st order Ni-La, Ti-La with HEG on HRC-I
SAMESUITE
target		Cu-La; Zr-La; Mo-La; Ag-La; Sn-La
shutter		HEG,ALL
max_fp_rate	40; 30; 30; 30; 30
GO

DEFAULT
UNCORRELATE

# Suite 7
# ___________________________________________________________________________
# These are the EA scans which involve coarse scans with the DCM.
# They repeat exactly all scans done in phase 1 (suite 23).
# Only running with LETG/HRC-S here.  HETG is used with ACIS-2C.
# ___________________________________________________________________________
source	DCM
target	N/A
name LE/Herman Marshall
grating		LETG
shutter		ALL,ALL
min_fp_counts	3000
detector	HRC,S
defocus		2

# split into three portions: small steps with TAP, small steps with Ge,
#   then large steps with Ge.
mono_init	1.5
mono_range	0.75
mono_step	0.25
GO

# small steps with Ge crystal
SAMESUITE
mono_init	2.5
mono_range	1.5
GO

# Finally, large steps with Ge crystal
SAMESUITE
mono_init	4.5
mono_range	4.5
mono_step	0.5
GO

# Suite 8
# ___________________________________________________________________________
# These are the EA scans which involve edge scans with the DCM.
# They repeat exactly all scans done in phase 1 (suite 24).
# Only running with LETG/HRC-S here.  HETG is used with ACIS-2C.
# EA survey of the Ir and Au edges with the DCM.  Use fine scans
#   near 2 keV.
# All gratings measured; the no-grating case is done by the HRMA
#   calibration team in phase 1.
# Same setup as for the last test, just different monochromator
#   settings.
# ___________________________________________________________________________
# First, a scan using the TAP crystal.
min_fp_counts	3000
mono_init	1.50
mono_range	0.60
mono_step	0.050
GO

# Second, a scan using the Ge crystal.
SAMESUITE
mono_init	2.15
mono_range	0.50
mono_step	0.050
GO

DEFAULT

# Suite 9
# ___________________________________________________________________________
# Next are energy scans using the HIREFS monochromator.
# LETG/HRC tests are better than those done with the HSI or an FPC
#   because the contaminating high order flux will be dispersed onto
#   the detector in first order, so its intensity can be estimated.
# ___________________________________________________________________________
source		HIREF-W
mono_resolution	300
defocus		0

# This first test is the only one that has high enough
#   priority to be in the 2A group, because the Au-N edge region
#   is nearly unmeasurable by other means.
# See suite 14 of phase 1.
# The count rate is so low that we need to reduce the objective
#   number of counts in order to keep this test from taking 2 days.
sequence	2A
mono_init	60
mono_step	8
mono_range	40
defocus		15.

min_fp_counts	1000
GO

# Suite 10
# ___________________________________________________________________________
# The rest of these edge scans are really intended to calibrate
#   features of the detectors.  They are listed in overall priority
#   order.  If the detector team does a proper job, then we may not
#   need to include the test here.
# ##### WARNING #########
# ALL TESTS NEED SPECIFICATIONS OF WAVELENGTH OR ENERGY RANGES AND
#   STEP SIZES
# -------
# The first set consists of HIREFS tests.
# The idea here is to scan across several HRC coating edges in the
#   0.6 - 1.0 keV region.  The HIREFS is set to low resolution in
#   order to make up a "mini-continuum" that is restricted in
#   wavelength but meanwhile allows the gratings to see features
#   in the range of the band passed by the HIREFS.  Fewer steps
#   are then needed to cover the entire region of interest.
# ___________________________________________________________________________

sequence	2B
mono_resolution	30
min_fp_counts	1000

# O-K region of HRC,S.
mono_init	20
mono_step	.4
mono_range	4
defocus		0
GO

SAMESUITE
# Cs-I 600-1000eV region of HRC,S.
# This scan was discussed in some detail.
mono_init	12
mono_range	9
mono_step	0.25
name HE/Herman Marshall
grating	HETG
shutter	MEG,ALL
detector	HRC,I
GO

SAMESUITE
# N-K region of HRC-S.
mono_init	26
mono_range	5
mono_step	0.5
name LE/Herman Marshall
grating	LETG
shutter	ALL,ALL
detector	HRC,S
GO

SAMESUITE
# CsI 200eV region of HRC-S.
mono_init	57
mono_range	10
mono_step	1.0
GO

# SAMESUITE
# Al-La region of HRC-S.
# Need to offset the HRMA to get to Al-L.
#   180 A is at 159mm from 0th order, so offset 0th order by 10 mm;
#   offset HRMA by 3.3 arcmin.
# Must be commented out for now because HIREFS can't get to this wavelength
# mono_init	155
# mono_range	25
# mono_step	2.5
# hrma_polar	3.3
# hrma_az		0
# GO

DEFAULT

# Suite 11
# ___________________________________________________________________________
# More edge scans.
# -------
# The second set consists of DCM tests.
# ___________________________________________________________________________
sequence	2B

source	DCM
target	N/A
mono_range	0.200
mono_step	0.020

# Al-K region of HRC-S.
mono_init	1.45
name LE/Herman Marshall
grating	LETG
shutter	ALL,ALL
detector	HRC,S
GO

# This test is a repeat in order to check out a different portion of
#   the HRC-S filter.
# Need to check value that this sim_z is good enough to change filter types.
SAMESUITE
sim_z	5
GO

sim_z	0
SAMESUITE

# Cs-I 5 keV region of HRC-I.
mono_init	4.9
name HE/Herman Marshall
grating	HETG
shutter	HEG,ALL
detector	HRC,I
GO

SAMESUITE

# Al-K region of HRC-I.
mono_init	1.45
name HE/Herman Marshall
grating	HETG
shutter	HEG,ALL; MEG,ALL
detector	HRC,I
GO

SAMESUITE
# Al-K region of HRC-I.  
name LE/Herman Marshall
grating	LETG
shutter	ALL,ALL
GO

DEFAULT
UNCORRELATE

# Suite 12
# ___________________________________________________________________________
# Finally, an effective area survey at low E.
# -------
# This series is just a few EIPS anodes used so that the entire
#    band is observed without significant emission lines.
# Test patterned after Phase 1 test with LETG.
# C anode produces bright K line, so there is a concern about pore
#   dosage/high flux.
# High order flux is a problem but the purpose of the test is to
#   look for unusual edges, so order separation may not be so important.
# Increasing optical depth in Be filter to reduce the count rate, which
#   would ordinarily be too high for the HRC.
# ___________________________________________________________________________
type Molecular Contamination
source	EIPS
target	C-Ka
flux_line_all	ALL
energy		0.277
voltage	15
filter1_mat	NONE
filter2_mat	Be

name LE/Herman Marshall
grating	LETG
shutter	ALL,ALL
detector	HRC,S
min_fp_counts	100000