Blame view

src/idl/dustem_compute_stokes.pro 5.7 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.
c256dc81   Annie Hughes   updated help
61
62
;-
  
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
63
64
65
66
67
68
IF keyword_set(help) THEN BEGIN
    doc_library,'dustem_compute_stokes'
    out=0.
    goto,the_end
ENDIF

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

5f04fa07   Ilyes Choubani   general update
72
fact = 1.e4*(*!dustem_HCD)/(4.*!pi)/(3.e8/1.e-6/(st.polsed).wav)*1.e20/1.e7
607060e5   Ilyes Choubani   test version
73
74
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...
75

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

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

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

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

IF scopes[0] NE 'NONE' THEN BEGIN          
4c8f2260   Jean-Philippe Bernard   improved
97
98
99
100
101
102
  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
103
          
4c8f2260   Jean-Philippe Bernard   improved
104
105
106
107
      
      ENDIF

  ENDFOR
4c8f2260   Jean-Philippe Bernard   improved
108

262cff06   Ilyes Choubani   minor changes to ...
109
ENDIF
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
110
;-----------------------------------------
5cb00808   Jean-Philippe Bernard   added some commen...
111
112
113
114
115
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...
116
117
118
119

;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
120
121
122
testnzero = where(U_spec EQ -0., ct_nzero)
if ct_nzero ne 0 then U_spec[testnzero] = 0

f2caf3f1   Ilyes Choubani   Debugging some er...
123

07372e26   Ilyes Choubani   Corrected huge pl...
124
125
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...
126

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
127
;INITIALIZING THE STOKES SEDS
0068116a   Ilyes Choubani   General update + ...
128
129
dustem_qsed = (*(*!dustem_data).qsed).values * 0.
dustem_used = (*(*!dustem_data).used).values * 0.
3f93c873   Ilyes Choubani   correcting "compu...
130
131
132
;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...
133
if not isarray(stI) THEN stop ; I don't get this test. It is unnecessary.
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
134

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
135
136
137
138
139
;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
140
141
    message,'SKIPPING color correction calculations',/info
ENDELSE
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
142

0068116a   Ilyes Choubani   General update + ...
143
144
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...
145
  
759a527d   Ilyes Choubani   general update
146
147
  
IF count_qsed NE 0 THEN BEGIN 
0068116a   Ilyes Choubani   General update + ...
148
  filter_names=((*(*!dustem_data).qsed).filt_names)[ind_qsed]
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
149
  if isa(dustem_qsed) then begin 
607060e5   Ilyes Choubani   test version
150
    sqsed=dustem_cc(st.polsed.wav,Q_spec,filter_names,cc=cc)
4c8f2260   Jean-Philippe Bernard   improved
151
    dustem_qsed[ind_qsed]=sqsed
4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
152
  endif
759a527d   Ilyes Choubani   general update
153
154
155
ENDIF

IF count_used NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
156
  filter_names=((*(*!dustem_data).used).filt_names)[ind_used]
4c8f2260   Jean-Philippe Bernard   improved
157
158
159
160
  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...
161
162
ENDIF

afde94a3   Ilyes Choubani   general update
163
164

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

0068116a   Ilyes Choubani   General update + ...
168
169
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
170
171

IF count_qspec NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
172
  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
173
ENDIF
5f04fa07   Ilyes Choubani   general update
174

759a527d   Ilyes Choubani   general update
175
IF count_uspec NE 0 THEN BEGIN
0068116a   Ilyes Choubani   General update + ...
176
  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...
177
ENDIF
759a527d   Ilyes Choubani   general update
178

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

3f93c873   Ilyes Choubani   correcting "compu...
182
183
out[0]=dustem_qsed
out[1]=dustem_used
fcb6eade   Ilyes Choubani   general update - ...
184

4fd64cbb   Ilyes Choubani   dustem_fit_sed_po...
185
186
187
188
189
190
191
192
;clean pointers
heap_gc

the_end:

RETURN,out

END