Data format¶
It is important to respect this format when preparing your data files. We use the format output of the SIP-Fuchs-III instrument and software.
Frequency, Amplitude, Phase shift, Amplit error, Phase error
6.000e+03, 1.17152e+05, -2.36226e+02, 1.171527e+01, 9.948376e-02
3.000e+03, 1.22177e+05, -1.46221e+02, 1.392825e+01, 1.134464e-01
1.500e+03, 1.25553e+05, -9.51099e+01, 2.762214e+01, 2.199114e-01
........., ..........., ............, ............, ............
........., ..........., ............, ............, ............
........., ..........., ............, ............, ............
4.575e-02, 1.66153e+05, -1.21143e+01, 1.947314e+02, 1.171115e+00
2.288e-02, 1.67988e+05, -9.36718e+00, 3.306003e+02, 1.9669860+00
1.144e-02, 1.70107e+05, -7.25533e+00, 5.630541e+02, 3.310889e+00
Note
- Save your data in .csv, .txt, .dat or any other format. The extension is not important as long as it is a ASCII file.
- Comma separation between columns is mandatory.
- The order of the columns is very important (Frequency, Amplitude, Phase shift, Amplitude error, Phase error).
- Phase units may be milliradians, radians or degrees.
- Units are specified as an initialization argument (e.g. ph_units=’mrad’).
- Amplitude units may be Ohm-m or Ohm, the data will be normalized.
- A number of header lines may be skipped function argument (e.g. in this case headers=1).
- Scientific or standard notation is OK.
Example data files¶
Several real-life data files are included with the BISIP package. These files contain
the complex resistivity spectra of mineralized rock samples.
Once you have installed BISIP in your Python environment, you may get the paths
to these data files using the DataFiles
class.
-
class
bisip.data.
DataFiles
(*args, **kwargs)¶ Bases:
dict
The following example shows how to get the absolute file paths to the BISIP data files in your Python installation.
from bisip import DataFiles
files = DataFiles() # initialize the dictionary
print(files.keys()) # see the various data file names
filepath = files['SIP-K389172'] # extract one path
print(filepath)