Blame view

src/idl/dustem_compute_stokes.pro 5.73 KB
283845da   Ilyes Choubani   Small corrections...
1
FUNCTION dustem_compute_stokes,p_dim,$
cee5beec   Jean-Philippe Bernard   just changed form...
2
3
4
5
6
                               st=st,$
                               Q_spec=Q_spec,$
                               U_spec=U_spec,$
                               PSI_spec=PSI_spec,$
                               dustem_psi_em=dustem_psi_em,$
cee5beec   Jean-Philippe Bernard   just changed form...
7
                               help=help
5f04fa07   Ilyes Choubani   general update
8

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
9
10
11
;+
; NAME:
;    dustem_compute_stokes
00dedb80   Annie Hughes   cosmetic changes ...
12
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
13
; PURPOSE:
07a51917   Ilyes Choubani   updating help sec...
14
;    Computes Stokes Parmeters SEDs for a given Dustem spectrum
00dedb80   Annie Hughes   cosmetic changes ...
15
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
16
17
; CATEGORY:
;    Dustem
00dedb80   Annie Hughes   cosmetic changes ...
18
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
19
; CALLING SEQUENCE:
2926480f   Ilyes Choubani   Modified header c...
20
;    out=dustem_compute_stokes(p_dim[,st=][,Q_spec=][,U_spec=][,PSI_spec=][,dustem_psi_em=][,/help])
00dedb80   Annie Hughes   cosmetic changes ...
21
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
22
23
; INPUTS:
;    p_dim      = parameter values
00dedb80   Annie Hughes   cosmetic changes ...
24
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
25
; OPTIONAL INPUT PARAMETERS:
07a51917   Ilyes Choubani   updating help sec...
26
;    st        = Dustem structure
00dedb80   Annie Hughes   cosmetic changes ...
27
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
28
; OUTPUTS:
07a51917   Ilyes Choubani   updating help sec...
29
30
31
;    out        = List Containing the Stokes parameters emission for spectrum points in !dustem_data 
;    out[0]     = Computed Stokes Q emission for spectrum points in !dustem_data
;    out[1]     = Computed Stokes U emission for spectrum points in !dustem_data 
00dedb80   Annie Hughes   cosmetic changes ...
32
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
33
; OPTIONAL OUTPUT PARAMETERS:
53e653c3   Jean-Philippe Bernard   removed unecessar...
34
;    st          = Dustem output structure
07a51917   Ilyes Choubani   updating help sec...
35
36
37
38
;    Q_spec        = Dustem Stokes Q emission 
;    U_spec        = Dustem Stokes U emission
;    PSI_spec      = Dustem Polarization angle output in emission
;    dustem_psi_em = Computed Polarization angle ouput for spectrum points in !dustem_data
00dedb80   Annie Hughes   cosmetic changes ...
39
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
40
41
; ACCEPTED KEY-WORDS:
;    help      = If set, print this help
00dedb80   Annie Hughes   cosmetic changes ...
42
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
43
44
; COMMON BLOCKS:
;    None
00dedb80   Annie Hughes   cosmetic changes ...
45
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
46
47
; SIDE EFFECTS:
;    None
00dedb80   Annie Hughes   cosmetic changes ...
48
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
49
; RESTRICTIONS:
00dedb80   Annie Hughes   cosmetic changes ...
50
51
;    The DustEMWrap IDL code must be installed
;
2304e636   Annie Hughes   cosmetic help cha...
52
; PROCEDURES:
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
53
;    None
00dedb80   Annie Hughes   cosmetic changes ...
54
;
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
55
56
57
; EXAMPLES
;    
; MODIFICATION HISTORY:
00dedb80   Annie Hughes   cosmetic changes ...
58
59
60
;    Written by J.-Ph. Bernard 2021
;    Evolution details on the DustEMWrap gitlab
;    See http://dustemwrap.irap.omp.eu/ for FAQ and help.
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
61
62
63
64
65
66
67

IF keyword_set(help) THEN BEGIN
    doc_library,'dustem_compute_stokes'
    out=0.
    goto,the_end
ENDIF

00dedb80   Annie Hughes   cosmetic changes ...
68
IF not keyword_set(st) THEN $
53e653c3   Jean-Philippe Bernard   removed unecessar...
69
    dustem_activate_plugins,p_dim/(*(*!dustem_fit).param_init_values),st=st
607060e5   Ilyes Choubani   test version
70

5f04fa07   Ilyes Choubani   general update
71
fact = 1.e4*(*!dustem_HCD)/(4.*!pi)/(3.e8/1.e-6/(st.polsed).wav)*1.e20/1.e7
607060e5   Ilyes Choubani   test version
72
73
stI = st.sed.em_tot * fact    ;This is Total intensity I
P = st.polsed.em_tot * fact   ;This is Polarized intensity P
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
74

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
75
76
77
78
79
80
Nwaves=(size(stI))[1]

frac=P/stI
tes=where(finite(frac) eq 0)
frac(tes)=0.

4c8f2260   Jean-Philippe Bernard   improved
81
82
83
84
85
86
87
88
scopes=tag_names((*!dustem_plugin))
IF scopes[0] NE 'NONE' THEN BEGIN
  FOR i=0L,n_tags(*!dustem_plugin)-1 DO BEGIN   
      
      IF total(strsplit((*(*!dustem_plugin).(i).scope),'+',/extract) EQ 'REPLACE_POLSED') THEN BEGIN
          
          Q_spec = (*(*!dustem_plugin).(i).spec)[*,1]
          U_spec = (*(*!dustem_plugin).(i).spec)[*,2]
4c8f2260   Jean-Philippe Bernard   improved
89
90
91
92
          
      ENDIF 

  ENDFOR    
262cff06   Ilyes Choubani   minor changes to ...
93
94
  
ENDIF
4c8f2260   Jean-Philippe Bernard   improved
95
96

  IF ~isa(Q_spec) && ~isa(U_spec) THEN BEGIN
07372e26   Ilyes Choubani   Corrected huge pl...
97
      polar_ippsi2iqu,stI,Q_spec,U_spec,frac,replicate(!dustem_psi,Nwaves);     
4c8f2260   Jean-Philippe Bernard   improved
98
  ENDIF    
262cff06   Ilyes Choubani   minor changes to ...
99
100

IF scopes[0] NE 'NONE' THEN BEGIN          
4c8f2260   Jean-Philippe Bernard   improved
101
102
103
104
105
106
  FOR i=0L,n_tags(*!dustem_plugin)-1 DO BEGIN
      
      IF total(strsplit((*(*!dustem_plugin).(i).scope),'+',/extract) EQ 'ADD_POLSED') THEN BEGIN
          
          Q_spec+=(*(*!dustem_plugin).(i).spec)[*,1]
          U_spec+=(*(*!dustem_plugin).(i).spec)[*,2]
afde94a3   Ilyes Choubani   general update
107
          
4c8f2260   Jean-Philippe Bernard   improved
108
109
110
111
      
      ENDIF

  ENDFOR
4c8f2260   Jean-Philippe Bernard   improved
112

262cff06   Ilyes Choubani   minor changes to ...
113
ENDIF
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
114
;-----------------------------------------
5cb00808   Jean-Philippe Bernard   added some commen...
115
116
117
118
119
ind=where(finite(U_spec) NE 1 OR finite(Q_spec) NE 1,count)
IF count NE 0 THEN BEGIN
  message,'Q or U is NaN',/continue
  stop
ENDIF
f2caf3f1   Ilyes Choubani   Debugging some er...
120
121
122
123

;Hard-coded block so that atan(U,Q) does not return wrong values when Q eq -0
testnzero = where(Q_spec EQ -0., ct_nzero)
if ct_nzero ne 0 then Q_spec[testnzero] = 0
4b745987   Ilyes Choubani   minor update
124
125
126
testnzero = where(U_spec EQ -0., ct_nzero)
if ct_nzero ne 0 then U_spec[testnzero] = 0

f2caf3f1   Ilyes Choubani   Debugging some er...
127

07372e26   Ilyes Choubani   Corrected huge pl...
128
129
PSI_spec = 0.5*atan(U_spec,Q_spec)/!dtor
;polar_iqu2ippsi,stI,Q_spec,U_spec,p_bidon,PSI_spec ;same but this line runs several commands for each iteration of this current procedure
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
130

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
131
;INITIALIZING THE STOKES SEDS
0068116a   Ilyes Choubani   General update + ...
132
133
dustem_qsed = (*(*!dustem_data).qsed).values * 0.
dustem_used = (*(*!dustem_data).used).values * 0.
3f93c873   Ilyes Choubani   correcting "compu...
134
135
136
;using a list because the arrays can have different dimensions
;this doesn't change anything ...
out=list(fltarr(n_elements(dustem_qsed)),fltarr(n_elements(dustem_used)))
68598bce   Ilyes Choubani   reducing number o...
137
if not isarray(stI) THEN stop ; I don't get this test. It is unnecessary.
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
138

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
139
140
141
142
143
;Performing color corrections on the dustem spectra and generating the SEDs at the given filters 

IF !dustem_do_cc NE 0 AND !dustem_never_do_cc EQ 0 THEN BEGIN
    message,'DOING color correction calculations',/info
ENDIF ELSE BEGIN
4c8f2260   Jean-Philippe Bernard   improved
144
145
    message,'SKIPPING color correction calculations',/info
ENDELSE
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
146

0068116a   Ilyes Choubani   General update + ...
147
148
ind_qsed=where((*(*!dustem_data).qsed).filt_names NE 'SPECTRUM',count_qsed)
ind_used=where((*(*!dustem_data).used).filt_names NE 'SPECTRUM',count_used)
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
149
  
759a527d   Ilyes Choubani   general update
150
151
  
IF count_qsed NE 0 THEN BEGIN 
0068116a   Ilyes Choubani   General update + ...
152
  filter_names=((*(*!dustem_data).qsed).filt_names)[ind_qsed]
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
153
  if isa(dustem_qsed) then begin 
607060e5   Ilyes Choubani   test version
154
    sqsed=dustem_cc(st.polsed.wav,Q_spec,filter_names,cc=cc)
4c8f2260   Jean-Philippe Bernard   improved
155
    dustem_qsed[ind_qsed]=sqsed
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
156
  endif
759a527d   Ilyes Choubani   general update
157
158
159
ENDIF

IF count_used NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
160
  filter_names=((*(*!dustem_data).used).filt_names)[ind_used]
4c8f2260   Jean-Philippe Bernard   improved
161
162
163
164
  if isa(dustem_used) then begin
    sused=dustem_cc(st.polsed.wav,U_spec,filter_names,cc=cc)
    dustem_used[ind_used]=sused
  endif
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
165
166
ENDIF

afde94a3   Ilyes Choubani   general update
167
168

;For spectrum data points, interpolate in log-logdustem_compute_stokes.pro
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
169
170
171
;Linear interpolation leads to wrong values, in particular where few
;wavelengths points exist in the model (long wavelengths).

0068116a   Ilyes Choubani   General update + ...
172
173
ind_qspec=where((*(*!dustem_data).qsed).filt_names EQ 'SPECTRUM',count_qspec)
ind_uspec=where((*(*!dustem_data).used).filt_names EQ 'SPECTRUM',count_uspec)
759a527d   Ilyes Choubani   general update
174
175

IF count_qspec NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
176
  if isa(dustem_qsed) then dustem_qsed[ind_qspec]=interpol(Q_spec,st.polsed.wav,(((*(*!dustem_data).qsed).wav)[ind_qspec]))  
759a527d   Ilyes Choubani   general update
177
ENDIF
5f04fa07   Ilyes Choubani   general update
178

759a527d   Ilyes Choubani   general update
179
IF count_uspec NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
180
  if isa(dustem_used) then dustem_used[ind_uspec]=interpol(U_spec,st.polsed.wav,(((*(*!dustem_data).used).wav)[ind_uspec]))
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
181
ENDIF
759a527d   Ilyes Choubani   general update
182

fcb6eade   Ilyes Choubani   general update - ...
183
;generating interpolates for Psi_em
07372e26   Ilyes Choubani   Corrected huge pl...
184
dustem_psi_em = 0.5*atan(dustem_used,dustem_qsed)/!dtor
fcb6eade   Ilyes Choubani   general update - ...
185

3f93c873   Ilyes Choubani   correcting "compu...
186
187
out[0]=dustem_qsed
out[1]=dustem_used
fcb6eade   Ilyes Choubani   general update - ...
188

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
189
190
191
192
193
194
195
196
;clean pointers
heap_gc

the_end:

RETURN,out

END