Blame view

src/idl/dustem_read_fits_table.pro 9.96 KB
762cbe48   Jean-Philippe Bernard   modifed to cope f...
1
PRO dustem_read_fits_table,filename=filename,dustem_st=dustem_st,help=help
a1839067   Jean-Philippe Bernard   First commit
2
3
4
5

;+
; NAME:
;    dustem_read_fits_table
66c3a3ea   Annie Hughes   cosmetic changes ...
6
;
a1839067   Jean-Philippe Bernard   First commit
7
; PURPOSE:
201cf7e2   Annie Hughes   minor changes to ...
8
;    Reads a Dustem fits table into current DustEMWrap system variables
66c3a3ea   Annie Hughes   cosmetic changes ...
9
;
a1839067   Jean-Philippe Bernard   First commit
10
; CATEGORY:
90c53809   Annie Hughes   updated doc heade...
11
;    DustEMWrap, High-Level, Distributed, User convenience
66c3a3ea   Annie Hughes   cosmetic changes ...
12
;
a1839067   Jean-Philippe Bernard   First commit
13
14
; CALLING SEQUENCE:
;    dustem_read_fits_table[,filename=][,/help]
66c3a3ea   Annie Hughes   cosmetic changes ...
15
;
a1839067   Jean-Philippe Bernard   First commit
16
; INPUTS:
66c3a3ea   Annie Hughes   cosmetic changes ...
17
;
a1839067   Jean-Philippe Bernard   First commit
18
; OPTIONAL INPUT PARAMETERS:
201cf7e2   Annie Hughes   minor changes to ...
19
;    filename      = File name to be read (default='./dustemwrap_results.fits')
66c3a3ea   Annie Hughes   cosmetic changes ...
20
;
a1839067   Jean-Philippe Bernard   First commit
21
22
; OUTPUTS:
;    None
66c3a3ea   Annie Hughes   cosmetic changes ...
23
;
a1839067   Jean-Philippe Bernard   First commit
24
; OPTIONAL OUTPUT PARAMETERS:
762cbe48   Jean-Philippe Bernard   modifed to cope f...
25
;    dustem_st = emission and extinction dustem output structure (total and for each grain type)
66c3a3ea   Annie Hughes   cosmetic changes ...
26
;
a1839067   Jean-Philippe Bernard   First commit
27
28
; ACCEPTED KEY-WORDS:
;    help      = If set, print this help
66c3a3ea   Annie Hughes   cosmetic changes ...
29
;
a1839067   Jean-Philippe Bernard   First commit
30
31
; COMMON BLOCKS:
;    None
66c3a3ea   Annie Hughes   cosmetic changes ...
32
;
a1839067   Jean-Philippe Bernard   First commit
33
; SIDE EFFECTS:
201cf7e2   Annie Hughes   minor changes to ...
34
;    DustEMWrap system variables are set
66c3a3ea   Annie Hughes   cosmetic changes ...
35
;
a1839067   Jean-Philippe Bernard   First commit
36
; RESTRICTIONS:
201cf7e2   Annie Hughes   minor changes to ...
37
;    The DustEMWrap IDL code must be installed
66c3a3ea   Annie Hughes   cosmetic changes ...
38
;
a1839067   Jean-Philippe Bernard   First commit
39
40
; PROCEDURE:
;    None
66c3a3ea   Annie Hughes   cosmetic changes ...
41
;
a1839067   Jean-Philippe Bernard   First commit
42
43
44
; EXAMPLES
;    
; MODIFICATION HISTORY:
1cf2bf59   Annie Hughes   updated dustem_da...
45
46
47
;    Written by J.-Ph. Bernard July 2022
;    Evolution details on the DustEMWrap gitlab.
;    See http://dustemwrap.irap.omp.eu/ for FAQ and help.  
a1839067   Jean-Philippe Bernard   First commit
48
49
;-

a1839067   Jean-Philippe Bernard   First commit
50
51
52
53
54
55
56
57
58
59

IF keyword_set(help) THEN BEGIN
  doc_library,'dustem_read_fits_table'
  goto,the_end
ENDIF

;write final file
IF keyword_set(filename) THEN BEGIN
	file=filename
ENDIF ELSE BEGIN
1cf2bf59   Annie Hughes   updated dustem_da...
60
	file='./dustemwrap_results.fits'
a1839067   Jean-Philippe Bernard   First commit
61
62
63
ENDELSE
message,'Reading '+file,/info

762cbe48   Jean-Philippe Bernard   modifed to cope f...
64
toto=mrdfits(file,0,main_header)
a1839067   Jean-Philippe Bernard   First commit
65

762cbe48   Jean-Philippe Bernard   modifed to cope f...
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
;get extention numbers from main header
current_ext=1
ext_names=['']
exts=[-1]
finished=0
WHILE not finished DO BEGIN
	ext_name=sxpar(main_header,'EXT'+strtrim(current_ext,2),count=count)
	IF count NE 0 THEN BEGIN
		ext_names=[ext_names,ext_name]
		exts=[exts,current_ext]
		current_ext=current_ext+1
	ENDIF ELSE BEGIN
		finished=1
	ENDELSE
ENDWHILE
ext_names=ext_names[1:*]
exts=exts[1:*]
Nextensions=n_elements(exts)

message,'================================================',/info
message,'Reading '+file,/info
message,'File extensions detected are: ',/info
FOR i=0L,Nextensions-1 DO BEGIN
	message,'extension '+strtrim(exts[i],2)+' : '+strtrim(ext_names[i],2),/info
ENDFOR
message,'================================================',/info

17f02a5a   Jean-Philippe Bernard   updated
93
94
;extensions_strs=['INPUT_EMISSION_SED','DUSTEM_PREDICTED_SED','DUSTEM_SHOWN_SED', $
;				 'INPUT_EXTINCTION_SED','DUSTEM_PREDICTED_EXTINCTION_SED','DUSTEM_SHOWN_EXTINCTION_SED', $
762cbe48   Jean-Philippe Bernard   modifed to cope f...
95
96
97
98
99
100
;				 'DUSTEM_PREDICTED_EMISSION_SPECTRA','DUSTEM_PREDICTED_EXTINCTION_SPECTRA', $
;				 'DUSTEM_PREDICTED_EMISSION_SPECTRA_POL','DUSTEM_PREDICTED_EXTINCTION_SPECTRA_POL']

ind=where(ext_names EQ 'INPUT_EMISSION_SED',count)
IF count NE 0 THEN BEGIN
	unit_input_emission_sed=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
101
	;print,unit_input_emission_sed
762cbe48   Jean-Philippe Bernard   modifed to cope f...
102
103
104
105
106
107
ENDIF ELSE BEGIN
    unit_input_emission_sed=-1
ENDELSE
ind=where(ext_names EQ 'DUSTEM_PREDICTED_SED',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_sed=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
108
	;print,unit_dustem_predicted_sed
762cbe48   Jean-Philippe Bernard   modifed to cope f...
109
110
111
ENDIF ELSE BEGIN
    unit_dustem_predicted_sed=-1
ENDELSE
17f02a5a   Jean-Philippe Bernard   updated
112
113
114
115
116
117
118
ind=where(ext_names EQ 'DUSTEM_SHOWN_SED',count)
IF count NE 0 THEN BEGIN
	unit_dustem_shown_sed=exts[ind[0]]
	;print,unit_dustem_predicted_sed
ENDIF ELSE BEGIN
    unit_dustem_shown_sed=-1
ENDELSE
762cbe48   Jean-Philippe Bernard   modifed to cope f...
119
120
121
122

ind=where(ext_names EQ 'INPUT_EXTINCTION_SED',count)
IF count NE 0 THEN BEGIN
	unit_input_extinction_sed=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
123
	;print,unit_input_extinction_sed
762cbe48   Jean-Philippe Bernard   modifed to cope f...
124
125
126
127
128
129
ENDIF ELSE BEGIN
    unit_input_extinction_sed=-1
ENDELSE
ind=where(ext_names EQ 'DUSTEM_PREDICTED_EXTINCTION_SED',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_extinction_sed=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
130
	;print,unit_dustem_predicted_extinction_sed
762cbe48   Jean-Philippe Bernard   modifed to cope f...
131
132
133
ENDIF ELSE BEGIN
	unit_dustem_predicted_extinction_sed=-1   ;That would be abnormal
ENDELSE
17f02a5a   Jean-Philippe Bernard   updated
134
135
136
137
138
139
140
ind=where(ext_names EQ 'DUSTEM_SHOWN_EXTINCTION_SED',count)
IF count NE 0 THEN BEGIN
	unit_dustem_shown_extinction_sed=exts[ind[0]]
	;print,unit_dustem_predicted_extinction_sed
ENDIF ELSE BEGIN
	unit_dustem_shown_extinction_sed=-1   ;That would be abnormal
ENDELSE
762cbe48   Jean-Philippe Bernard   modifed to cope f...
141
142
143
144

ind=where(ext_names EQ 'DUSTEM_PREDICTED_EMISSION_SPECTRA',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_emission_spectra=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
145
	;print,unit_dustem_predicted_emission_spectra
762cbe48   Jean-Philippe Bernard   modifed to cope f...
146
147
148
149
150
151
ENDIF ELSE BEGIN
	unit_dustem_predicted_emission_spectra=-1   ;That would be abnormal
ENDELSE
ind=where(ext_names EQ 'DUSTEM_PREDICTED_EXTINCTION_SPECTRA',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_extinction_spectra=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
152
	;print,unit_dustem_predicted_extinction_spectra
762cbe48   Jean-Philippe Bernard   modifed to cope f...
153
154
155
156
157
158
159
ENDIF ELSE BEGIN
	unit_dustem_predicted_extinction_spectra=-1   ;That would be abnormal
ENDELSE

ind=where(ext_names EQ 'DUSTEM_PREDICTED_EMISSION_SPECTRA_POL',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_emission_spectra_pol=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
160
	;print,unit_dustem_predicted_emission_spectra_pol
762cbe48   Jean-Philippe Bernard   modifed to cope f...
161
162
163
164
165
166
ENDIF ELSE BEGIN
	unit_dustem_predicted_emission_spectra_pol=-1
ENDELSE
ind=where(ext_names EQ 'DUSTEM_PREDICTED_EXTINCTION_SPECTRA_POL',count)
IF count NE 0 THEN BEGIN
	unit_dustem_predicted_extinction_spectra_pol=exts[ind[0]]
0dda35a7   Jean-Philippe Bernard   modified to inclu...
167
	;print,unit_dustem_predicted_extinction_spectra_pol
762cbe48   Jean-Philippe Bernard   modifed to cope f...
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
ENDIF ELSE BEGIN
	unit_dustem_predicted_extinction_spectra_pol=-1
ENDELSE

;stop

; unit_input_sed=sxpar(main_header,'INPUT_EMISSION_SED')
; unit_predicted_sed=sxpar(main_header,'DUSTEM_PREDICTED_SED')
; unit_predicted_spectra=sxpar(main_header,'DUSTEM_PREDICTED_EMISSION')
; unit_predicted_extinctions=sxpar(main_header,'DUSTEM_PREDICTED_EXTINCTION')
; unit_predicted_spectra_pol=sxpar(main_header,'DUSTEM_PREDICTED_EMISSION_POL')
; unit_predicted_extinctions_pol=sxpar(main_header,'DUSTEM_PREDICTED_EXTINCTION_POL')

;==== read the observed SED (if any)
IF unit_input_emission_sed NE -1 THEN BEGIN
	str_input_SED=mrdfits(file,unit_input_emission_sed,header_input_sed)
ENDIF ELSE BEGIN
ENDELSE
;==== read the predicted SED (if any)
IF unit_dustem_predicted_sed NE -1 THEN BEGIN
	str_predicted_SED=mrdfits(file,unit_dustem_predicted_sed,header_predicted_SED)
ENDIF ELSE BEGIN
ENDELSE
17f02a5a   Jean-Philippe Bernard   updated
191
192
193
194
195
196
;==== read the shown SED (if any)
;stop
IF unit_dustem_shown_sed NE -1 THEN BEGIN
	str_shown_SED=mrdfits(file,unit_dustem_shown_sed,header_shown_SED)
ENDIF ELSE BEGIN
ENDELSE
762cbe48   Jean-Philippe Bernard   modifed to cope f...
197
198
199
200
201
202
203
204
IF unit_input_extinction_sed NE -1 THEN BEGIN
	str_input_EXT=mrdfits(file,unit_input_extinction_sed,header_input_ext)
ENDIF ELSE BEGIN
ENDELSE
IF unit_dustem_predicted_extinction_sed NE -1 THEN BEGIN
	str_predicted_EXT=mrdfits(file,unit_input_extinction_sed,header_input_ext)
ENDIF ELSE BEGIN
ENDELSE
17f02a5a   Jean-Philippe Bernard   updated
205
206
207
208
IF unit_dustem_shown_extinction_sed NE -1 THEN BEGIN
	str_shown_EXT=mrdfits(file,unit_shown_extinction_sed,header_shown_ext)
ENDIF ELSE BEGIN
ENDELSE
a1839067   Jean-Philippe Bernard   First commit
209

762cbe48   Jean-Philippe Bernard   modifed to cope f...
210
211
212
used_model=strtrim(sxpar(main_header,'MODEL'),2)
used_pol=long(strtrim(sxpar(main_header,'POL'),2))
used_version=strtrim(sxpar(main_header,'WRAP_V'),2)
7bb82b3b   Ilyes Choubani   remove lingering ...
213

72089d7a   Jean-Philippe Bernard   improved to save ...
214
IF used_model NE 'DEFAULT' THEN BEGIN
7bb82b3b   Ilyes Choubani   remove lingering ...
215
 	dustem_init,model=used_model,pol=used_pol
72089d7a   Jean-Philippe Bernard   improved to save ...
216
ENDIF ELSE BEGIN
7bb82b3b   Ilyes Choubani   remove lingering ...
217
   	dustem_init,model=0
72089d7a   Jean-Philippe Bernard   improved to save ...
218
ENDELSE
7bb82b3b   Ilyes Choubani   remove lingering ...
219

b7dca888   Jean-Philippe Bernard   improved to recov...
220
221
defsysv,'!dustem_hcd',ptr_new(float(sxpar(header_input_sed,'NH')))

72089d7a   Jean-Philippe Bernard   improved to save ...
222
!dustem_model=used_model
762cbe48   Jean-Philippe Bernard   modifed to cope f...
223
224
225
226
227
IF !dustem_version.version NE used_version THEN BEGIN
	message,'Caution: fits file was not created with the same Dustemwrap version as your current version',/continue
	message,'Fits dustemwrap version is    :'+used_version,/continue
	message,'current dustemwrap version is :'+!dustem_version.version,/continue
	stop
a1839067   Jean-Philippe Bernard   First commit
228
229
ENDIF

762cbe48   Jean-Philippe Bernard   modifed to cope f...
230
231
best_fit_chi2=sxpar(main_header,'CHI2')
best_fit_rchi2=sxpar(main_header,'RCHI2')
a1839067   Jean-Philippe Bernard   First commit
232

762cbe48   Jean-Philippe Bernard   modifed to cope f...
233
234
;==== get parameter values
Nparams=sxpar(main_header,'NPARAMS')
a1839067   Jean-Philippe Bernard   First commit
235
236
237
238
parameters_desc=strarr(Nparams)
best_parameters=dblarr(Nparams)
best_parameters_init_values=dblarr(Nparams)
best_parameters_uncertainties=dblarr(Nparams)
72089d7a   Jean-Philippe Bernard   improved to save ...
239
parameters_func_values=dblarr(Nparams)
a1839067   Jean-Philippe Bernard   First commit
240
FOR i=0L,Nparams-1 DO BEGIN
762cbe48   Jean-Philippe Bernard   modifed to cope f...
241
242
243
244
	parameters_desc[i]=sxpar(main_header,'PARN'+strtrim(i+1,2))
	best_parameters[i]=sxpar(main_header,'PARV'+strtrim(i+1,2))
	best_parameters_uncertainties[i]=sxpar(main_header,'PARU'+strtrim(i+1,2))
	best_parameters_init_values[i]=sxpar(main_header,'PARI'+strtrim(i+1,2))
7bb82b3b   Ilyes Choubani   remove lingering ...
245
	parameters_func_values[i]=sxpar(main_header,'PARF'+strtrim(i+1,2))
a1839067   Jean-Philippe Bernard   First commit
246
247
ENDFOR

72089d7a   Jean-Philippe Bernard   improved to save ...
248
249
250
251
252
253
254
(*!dustem_fit).PARAM_DESCS=ptr_new(parameters_desc)
(*!dustem_fit).PARAM_INIT_VALUES=ptr_new(best_parameters_init_values)
(*!dustem_fit).CURRENT_PARAM_VALUES=ptr_new(best_parameters)
(*!dustem_fit).CURRENT_PARAM_ERRORS=ptr_new(best_parameters_uncertainties)
(*!dustem_fit).CHI2=best_fit_chi2
(*!dustem_fit).RCHI2=best_fit_rchi2
(*!dustem_fit).PARAM_FUNC=ptr_new(parameters_func_values)
a1839067   Jean-Philippe Bernard   First commit
255

762cbe48   Jean-Philippe Bernard   modifed to cope f...
256
;==== This is to create (*!dustem_data).sed in case it does not exist already
7bb82b3b   Ilyes Choubani   remove lingering ...
257
; it doesn't exist at all times because dustem_init has been run
762cbe48   Jean-Philippe Bernard   modifed to cope f...
258
IF unit_input_emission_sed NE -1 THEN BEGIN
b7dca888   Jean-Philippe Bernard   improved to recov...
259
260
261
	;Nsed=n_elements(str_input_SED)
	;sed=dustem_initialize_internal_sed(Nsed)
	dustem_fillup_systvar_from_fits,*!dustem_data,str_input_SED,used_pol
17f02a5a   Jean-Philippe Bernard   updated
262
ENDIF
762cbe48   Jean-Philippe Bernard   modifed to cope f...
263

17f02a5a   Jean-Philippe Bernard   updated
264
265
;help,str_shown_SED
;stop
762cbe48   Jean-Philippe Bernard   modifed to cope f...
266

17f02a5a   Jean-Philippe Bernard   updated
267
268
;==== This is to create (*!dustem_show).sed in case it does not exist already
IF unit_dustem_shown_sed NE -1 THEN BEGIN
b7dca888   Jean-Philippe Bernard   improved to recov...
269
270
271
	;Nsed=n_elements(str_shown_SED)
	;sed=dustem_initialize_internal_sed(Nsed)
	dustem_fillup_systvar_from_fits,*!dustem_show,str_shown_SED,used_pol
762cbe48   Jean-Philippe Bernard   modifed to cope f...
272
273
274
ENDIF

IF unit_input_extinction_sed NE -1 THEN BEGIN
b7dca888   Jean-Philippe Bernard   improved to recov...
275
276
277
278
279
280
281
	;Next=n_elements(str_input_EXT)
	;ext=dustem_initialize_internal_sed(Next)
	dustem_fillup_systvar_from_fits,*!dustem_data,str_input_EXT,used_pol
ENDIF

IF unit_dustem_shown_extinction_sed NE -1 THEN BEGIN
	dustem_fillup_systvar_from_fits,*!dustem_show,str_shown_EXT,used_pol
762cbe48   Jean-Philippe Bernard   modifed to cope f...
282
283
ENDIF

a1839067   Jean-Philippe Bernard   First commit
284
285
;=== Below is only to get the same output form as dustem_compute_sed
;Note: If the same model is used, the outputs should be the same as what is in the fits file ....
762cbe48   Jean-Philippe Bernard   modifed to cope f...
286
287
288
289
290
291
IF unit_input_emission_sed NE -1 THEN BEGIN
	recomputed_dustem_predicted_emission_sed=dustem_compute_sed(*(*!dustem_fit).current_param_values,st=dustem_st)
ENDIF ELSE BEGIN
	recomputed_dustem_predicted_ext_sed=dustem_compute_ext(*(*!dustem_fit).current_param_values,st=dustem_st)
ENDELSE

762cbe48   Jean-Philippe Bernard   modifed to cope f...
292
293
294
dustem_predicted_em=mrdfits(file,unit_dustem_predicted_emission_spectra,header_predicted_emission)
dustem_predicted_ext= mrdfits(file,unit_dustem_predicted_extinction_spectra,header_predicted_extinction)

7bb82b3b   Ilyes Choubani   remove lingering ...
295
dustem_st.sed=dustem_predicted_em   
762cbe48   Jean-Philippe Bernard   modifed to cope f...
296
dustem_st.ext=dustem_predicted_ext
90c53809   Annie Hughes   updated doc heade...
297

762cbe48   Jean-Philippe Bernard   modifed to cope f...
298
299
300
301
302
303
304
IF used_pol THEN BEGIN
	toto=mrdfits(file,unit_dustem_predicted_emission_spectra_pol,header_predicted_spectra_pol)
	;help,dustem_st.polsed,toto,/str
	dustem_st.polsed=toto
	toto=mrdfits(file,unit_dustem_predicted_extinction_spectra_pol,header_predicted_extinctions_pol)
    dustem_st.polext=toto
ENDIF
a1839067   Jean-Philippe Bernard   First commit
305

a1839067   Jean-Philippe Bernard   First commit
306
307
308
the_end:

END