Headers for LASCO IDL Library: POLARIZ

This page was created by IDL lasco_mk_html_help.pro on Wed Aug 17 12:21:59 2005.


List of Routines


Routine Descriptions

C2_VIG1

[List of Routines] (See ./c2_vig1.pro)

vignetting function for C2
 INPUT: suncen_x, suncenter_y
 OUTPUT: vignetting array (floating point array)  

 Created: Dennis Wang

 @(#)c2_vig1.pro	1.2 02/12/99 NRL LASCO IDL LIBRARY


DO_POLARIZ

[List of Routines] (See ./do_polariz.pro)

 NAME:			do_polariz

 PURPOSE:		Reduce Polarization Sequences for C1, C2 & C3

 CATEGORY:
 CALLING SEQUENCE:	do_polariz
 INPUTS:		NONE
		

 OPTIONAL INPUTS:	Batch Mode requires INDEXLIST, SAVEPATH, CAMERA keywords
                       and one or more of: SAVE_POLARIZ, SAVE_PERCENT, SAVE_MU,
                       SAVE,US,SAVE_UNPOLARIZ, SAVE_TOTAL, SAVE_JY, SAVE_JZ
                       SAVE_ALL

                       INDEXLIST = list of img_hdr.txt files including pathnames
                       SAVEPATH = location to put saved output files
                       CAMERA = camera number (C1 = 1, C2 = 2, C3 = 3)

                       DIFF - input difference images (C1)
		        C1TRIPLE - input 3 wavelength C1 images
			FIXC3ZERO - Define C3 +00 filter image to be 3.0*j0 - (j+60 + j-60)
                                   instead of using +00 image (must be used after 10/14/98)
                       PTF - point filter output files
			AUTO - for days with multiple PW sequences try to match
                              them automatically (BATCH mode only)
                       ROI = Region of Interest in pixels for computing Ave
                       SEQNO = sequence number of the day e.g to process the
                               2nd sequence of the day set seqno=2
                       DATATYPE = 5 for quicklook 
                                  1 for level 0 
                                  2 for level 1
 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        POLARIZ_DATA, POLARIZ_DISPLAY
 SIDE EFFECTS:
 RESTRICTIONS:
 PROCEDURE:
	 Example: Normal Interactive File Selection
	  do_polariz
	 Example: Batch Mode - File Selection by input file list
	  do_polariz,INDEXLIST='it.lst',SAVEPATH='/mypath',CAMERA=1,/SAVE_ALL
	 Example: Difference Image Analysis
	  do_polariz,/DIFF
	 Example: C3 Fix
	  do_polariz,/FIXC3ZERO

 MODIFICATION HISTORY:
	WRITTEN BY:	Dennis Wang, Interferometrics/NRL, 1996
       14 Jul 97       - Added SAVE_PERCENT
       27 Oct 97       - Added PTF - point filter keyword to batch
			  and interactive mode
			- changed output FITS headers
			- changed output filenames and type codes
			- changed output for brightness to DN instead of DN/sec
       10 Nov 97       - C2 & C3 vignetting Functions added to 'Recalc' Button
                       - Point Filter added to 'Recalc' Button
                       - saved Files now have LASCO FITS Headers 
                       - Added AUTO keyword - batch mode sequence matching
	27 Oct 98	- Added FixC3ZERO keyword and supporting code
       07 Jun 00       - Added SEQNO and DATATYPE Keywords
       15 Aug 2000     - Fixed CAMERA Keyword

	@(#)do_polariz.pro	1.7 03/05/01 LASCO IDL LIBRARY


PB_INVERTER

[List of Routines] (See ./pbinverter/pb_inverter.pro)

 NAME:
       PB_INVERTER

 PURPOSE:
       This program takes a calibrated pB image and returns the density
       using a Van de Hulst inversion.  A polynomial fit to the pB data
	of the form r^(-n), where n is user-defined, is inverted to get
	electron density.  Either single radial profiles or the entire
 	360 degrees in latitude can be processed.

 CATEGORY:
       Data analysis

 CALLING SEQUENCE:
       PB_INVERTER [,filename]


 OPTIONAL INPUTS:
       Filename: Enter the calibrated pB filename.  Default is to prompt
		user for filename

 OUTPUTS:
	Displays pB image, pB profiles, and calculated density profiles

 OPTIONAL OUTPUTS:
       Density data save in filenames as follows:
		pbne_YYYYMMDD_HHMM_Cx.sav;	where x is the telescope
		or
		pbne_YYYYMMDD_HHMM_Cx_aaa.sav;	where aaa is position angle

 COMMON BLOCKS:
       Programconstants:
	Simconstants:
	Widgetvars:
	Ipexpansionarg:


 PROCEDURE:
	The default is to look for pB files in the directory specified by
	the environment variable POLDIR

 EXAMPLE:
	pb_inverter

 MODIFICATION HISTORY:
       Written by:     R. Howard and A. Hayes
       various up to Nov 9, 2001 by D.A. Biesecker
		Modified so that the order of the polynomial fit and
		the width of the angular binnin can be set in the widget.
		Also modified to display the PA as the cursor is moved
		Many other mods which I've forgotted about.
       July 25, 2005   RA Howard  corrected error with Mk4 Header
                                  added simpb to the saveset
                                  added capability to set the max height in inversion

       @(#)pb_inverter.pro	1.2  07/25/05	LASCO IDL LIBRARY


POLARIZ

[List of Routines] (See ./polariz.pro)

@(#)polariz.pro	1.8 03/05/01 - NRL IDL Library

PURPOSE: POLARIZ.PRO defines a^2, a0^2, and mu

 assumption: e1, e2, e3 in that order around the horizontal axis
further assumption e1 = -60, e2 = 0, e3 = +60

 KEYWORDS: /Diff = input images are differenced images, do not adjust for bias or exposure times

 HISTORY
  1 Feb 2000   DW - Modified for lack of C3 +0 filter 
  7 Jun 2000   DW - Added seqno and datatype input vars


POLARIZ_CALC

[List of Routines] (See ./polariz_calc.pro)

 NAME:
	POLARIZ_CALC

 PURPOSE:
	
	This function produces the Stoke I, Q, U and parameters derived
       from them such as polarization angle, pB 
       Vignetting , point filtering is also done here

 CATEGORY:
	Data Analysis

 CALLING SEQUENCE:

       POLARIZ_CALC,j0,j1,j2,j3,filter0,filter1,filter2,filter3,batch_mode,ptf,vig

 
	Result = FUNCTION_NAME(Parameter1, Parameter2, Foobar)

 INPUTS:
	j0:	Raw Clear image
	j1:	Raw -60 image
	j2:	Raw 0 image
	j3:	Raw +60 image
	filter0: Filter for j0
	filter1: Filter for j1
	filter2: Filter for j2
       batch_mode : flag for batch mode,true = 1
       ptf : flag for point filter mode,true = 1
       vig : flag for vignetting,true = 1

 OPTIONAL INPUTS:
	
 KEYWORD PARAMETERS:

	DIFF: for C1 observations that have already had straylight and the
             continum removed by differencing	
	

 OUTPUTS:

 OPTIONAL OUTPUTS:

 COMMON BLOCKS:
	POLARIZ_DATA: Output Stokes and other parameters are placed here 
	POLARIZ_RTAN: Output j in radial and tangential coord system are here

 SIDE EFFECTS:

 RESTRICTIONS:

 PROCEDURE:

 EXAMPLE:

 MODIFICATION HISTORY:
 	Written by:	Dennis Wang
	11 Feb 1999 - Mueller matrices	
        1 Feb 2000 - Move FIXC3ZERO calculations  - DW
       12 Oct 2000 - polariz_rtan call changed to add cmu
       02 Mar 2001 - Added B0 call to c2_calibrate and c3_calibrate

	@(#)polariz_calc.pro	1.8 03/05/01 LASCO IDL LIBRARY - D. Wang


POLARIZ_DISPLAY

[List of Routines] (See ./polariz_display.pro)

 NAME:			polariz_display

 PURPOSE:		Widget Interface for do_polariz

 CATEGORY:
 CALLING SEQUENCE:	
 INPUTS:		NONE
		

 OPTIONAL INPUTS:	

 OUTPUTS:
 OPTIONAL OUTPUT PARAMETERS:
 COMMON BLOCKS:        POLARIZ_DATA
 SIDE EFFECTS:
 RESTRICTIONS:
      Requires JULDAT and DAYCNV from the IDL ASTRON Library
 PROCEDURE:

 MODIFICATION HISTORY:
	WRITTEN BY:	Dennis Wang, Interferometrics/NRL, 1996
       29 Sep 97       - Save File header changes
                          1. Date-OBS and TIME-OBS are now the average of
                             3 individual DATE-OBS and TIME-OBS 
                          2. Added as comment Exposure times of all 3 exposures; 
                          3. Added as comment offset bias 
                          4. Added file permission check prior to writing file
       4 Oct 99        Added roll to position angle calculation
      27 Oct 99        Changed PICKFILE to DIALOG_PICKFILE for IDL5.x 
       1 Feb 00        Removed FIXC3ZERO in polariz_calc call - DW
      15 Aug 2000      Fixed NaN values in % Pol when field stop mask is used 
      12 Oct 2000      Added Non Tang Angle display to Pol Angle Button
      01 Mar 2001      Fixed Raw.Clr Button Case statement
                       Added B0 Displays

	@(#)polariz_display.pro	1.16 03/05/01 NRL LASCO IDL LIBRARY


POLARIZ_RTAN

[List of Routines] (See ./polariz_rtan.pro)

 PURPOSE: convert to tangential frame of reference

 HISTORY:
 12 Oct 2000 - Added cmu array of angles for non tang angle - DW
 @(#)polariz_rtan.pro	1.2 03/06/01 - NRL IDL Library - D.Wang


This page was created by IDL lasco_mk_html_help.pro on Wed Aug 17 12:21:59 2005.