dustem_read_spin.pro
1.66 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
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
93
FUNCTION dustem_read_spin,file,silent=silent,help=help
;+
; NAME:
; dustem_read_spin
;
; PURPOSE:
; reads information relating to the grain spin
; from the corresponding .DAT file
;
; CATEGORY:
; DustEMWrap, Distributed, LowLevel, Initialization
;
; CALLING SEQUENCE:
; st=dustem_read_spin(file)
;
; INPUTS:
; file : input file to be read
;
; OPTIONAL INPUT PARAMETERS:
;
; OUTPUTS:
; st : dustem data structure
;
; OPTIONAL OUTPUT PARAMETERS:
;
; ACCEPTED KEY-WORDS:
; help : writes this help
;
; COMMON BLOCKS:
; None
;
; SIDE EFFECTS:
;
; RESTRICTIONS:
; The DustEM fortran code must be installed
; The DustEMWrap IDL code must be installed
;
; PROCEDURES AND SUBROUTINES USED:
;
; EXAMPLES:
;
; MODIFICATION HISTORY:
; Evolution details on the DustEMWrap gitlab.
; See http://dustemwrap.irap.omp.eu/ for FAQ and help.
;-
IF keyword_set(help) THEN BEGIN
doc_library,'dustem_read_spin'
full_st=0.
goto,the_end
ENDIF
;CAUTION: the data is read as strings ...
st=''
Nmax=10000L
sts=strarr(Nmax)
openr,unit,file,/get_lun
;==read comments
str=''
comments=['']
first_char='#'
Ncomments=0L
WHILE first_char EQ '#' DO BEGIN
readf,unit,str
first_char=strmid(str,0,1)
comments=[comments,str]
IF first_char EQ '#' THEN Ncomments=Ncomments+1
ENDWHILE
comments=comments[1:*]
IF Ncomments NE 0 THEN comments=comments[0:Ncomments-1]
;==read data
;last line in previous WHILE loop is first data
tmp = [str]
WHILE NOT EOF(unit) DO BEGIN
readf, unit, str
tmp = [tmp, str]
ENDWHILE
;==save and return structure
full_st={file:file,fspin:tmp,comments:comments}
close,unit
free_lun,unit
;stop
the_end:
RETURN,full_st
END