Fortran SFF API to data I/O streams in C++

◆ sff_rtracefi__()

int sff_rtracefi__ ( integer lu,
real tanf,
real dt,
char *  wid2line,
integer nsamp,
real fdata,
integer idata,
char *  code,
logical last,
integer nline,
char *  lines,
integer lindim,
integer lenmax,
char *  cs,
real c1,
real c2,
real c3,
integer nstack,
integer ierr,
ftnlen  wid2line_len,
ftnlen  code_len,
ftnlen  lines_len,
ftnlen  cs_len 
)

Read one trace of data and return FREE block and INFO line additionally.

Description from stuff.f:

c----------------------------------------------------------------------
subroutine sff_RTraceFI(lu, tanf, dt,
& wid2line, nsamp, fdata, idata, code, last,
& nline, lines, lindim, lenmax,
& cs, c1, c2, c3, nstack, ierr)
c
c Read one data block starting with DAST line.
c Read also FREE block and INFO line.
c The File will be closed after reading the last trace.
c
c input
c lu logical file unit
c lindim number of elements in FREE block array lines
c nsamp array dimension of idata and fdata
c ouput:
c ierr error status (ok: ierr=0)
c code code indicating optional blocks
c wid2line valid WID2 line
c tanf time of first sample from midnight
c dt sampling interval in seconds
c nsamp number of samples
c fdata data array
c last is true if read trace is the last one in this file
c nline number of FREE block lines read
c lines FREE block lines
c lenmax length of longest line in FREE block array lines
c cs coordinate system
c c1, c2, c3 receiver coordinates
c nstack number of stacks
c
c workspace:
c idata data will be first read to idata and then converted
c to fdata using sff_i2f (both array may be in same memory
c space - see comments on sff_f2i)
c
integer lu, nsamp, idata(nsamp), nline, nstack, lindim, lenmax
real fdata(nsamp), c1, c2, c3, dt, tanf
logical last
character wid2line*132, lines(lindim)*(*), cs*1, code*(*)
c----------------------------------------------------------------------

Definition at line 95 of file fapid_sff_rtracefi.cc.

References FAPIDXX_fuassert, fapidxx::fillfstring(), fapidxx::freeblock(), fapidxx::istreammanager, and fapidxx::maketanf().

102 {
103  int retval=0;
104  *ierr=0;
105  try {
106  datrw::ianystream &is=istreammanager(static_cast<int>(*lu));
107  sff::WID2 wid2;
108  sff::INFO info;
109  datrw::Tfseries iseries;
110  is >> iseries;
111  FAPIDXX_fuassert((static_cast<int>(iseries.size())<=(*nsamp)), *lu,
112  "sff_rtracefi__: too many samples");
113  int nsamples=iseries.size();
114  aff::LinearShape shape(0, nsamples-1, 0);
115  datrw::Tfseries series(shape, aff::SharedHeap<real>(fdata, *nsamp));
116  series.copyin(iseries);
117  *last = is.last() ? 1 : 0;
118  is >> wid2;
119  std::string ocode("");
120  if (is.hasfree()) { ocode.append("F"); }
121  if (is.hasinfo()) { ocode.append("I"); }
122  if (!is.last()) { ocode.append("D"); }
123  if (is.hasinfo()) { is >> info; }
124  fillfstring(ocode, code, code_len);
125  *tanf=static_cast<real>(maketanf(wid2.date));
126  *dt=static_cast<real>(wid2.dt);
127  fillfstring(wid2.line(), wid2line, wid2line_len);
128  *nsamp=series.size();
129  char thecs=sff::coosysID(info.cs);
130  fillfstring(std::string(&thecs, 1), cs, cs_len);
131  *c1=static_cast<real>(info.cx);
132  *c2=static_cast<real>(info.cy);
133  *c3=static_cast<real>(info.cz);
134  *nstack=info.nstacks;
135  sff::FREE free;
136  if (is.hasfree()) { is >> free; }
137  freeblock(free, nline, lines, lindim, lenmax, lines_len);
138  }
139  catch(...) {
140  *ierr=1;
141  }
142  return retval;
143 } // int sff_rtracefi__
sff::FREE freeblock(integer *nline, char *lines, ftnlen lines_len)
create C++ FREE block from Fortran FREE lines
Definition: helper.cc:150
void fillfstring(const std::string &s, char *fstring, ftnlen slen)
fill a Fortran string with a C++ string
Definition: helper.cc:60
#define FAPIDXX_fuassert(C, U, M)
Check an assertion and report by throwing an exception.
Definition: error.h:205
float real
Fortran real type (single precision)
Definition: fapidsff.h:73
float maketanf(const libtime::TAbsoluteTime &time)
create the tanf value
Definition: helper.cc:118
::fapidxx::IFileUnits istreammanager
the global istream manager
Definition: fileunit.cc:48
Here is the call graph for this function: