writer_hdf5.py module renamed fields_outputs.py

geometry_views.py module renamed geometry_outputs.py

gprMax/fields_outputs.py

@@ -0,0 +1,91 @@
+# Copyright (C) 2015-2016: The University of Edinburgh
+#                 Authors: Craig Warren and Antonis Giannopoulos
+#
+# This file is part of gprMax.
+#
+# gprMax is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# gprMax is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with gprMax.  If not, see <http://www.gnu.org/licenses/>.
+
+import h5py
+
+from gprMax._version import __version__
+
+
+def write_hdf5_outputfile(outputfile, Ex, Ey, Ez, Hx, Hy, Hz, G):
+    """Write an output file in HDF5 format.
+
+    Args:
+        outputfile (str): Name of the output file.
+        Ex, Ey, Ez, Hx, Hy, Hz (memory view): Current electric and magnetic field values.
+        G (class): Grid class instance - holds essential parameters describing the model.
+    """
+
+    f = h5py.File(outputfile, 'w')
+    f.attrs['gprMax'] = __version__
+    f.attrs['Title'] = G.title
+    f.attrs['Iterations'] = G.iterations
+    f.attrs['nx, ny, nz'] = (G.nx, G.ny, G.nz)
+    f.attrs['dx, dy, dz'] = (G.dx, G.dy, G.dz)
+    f.attrs['dt'] = G.dt
+    nsrc = len(G.voltagesources + G.hertziandipoles + G.magneticdipoles + G.transmissionlines)
+    f.attrs['nsrc'] = nsrc
+    f.attrs['nrx'] = len(G.rxs)
+    f.attrs['srcsteps'] = G.srcsteps
+    f.attrs['rxsteps'] = G.rxsteps
+
+    # Create group for sources (except transmission lines); add type and positional data attributes
+    srclist = G.voltagesources + G.hertziandipoles + G.magneticdipoles
+    for srcindex, src in enumerate(srclist):
+        grp = f.create_group('/srcs/src' + str(srcindex + 1))
+        grp.attrs['Type'] = type(src).__name__
+        grp.attrs['Position'] = (src.xcoord * G.dx, src.ycoord * G.dy, src.zcoord * G.dz)
+
+    # Create group for transmission lines; add positional data, line resistance and line discretisation attributes; write arrays for line voltages and currents
+    if G.transmissionlines:
+        for tlindex, tl in enumerate(G.transmissionlines):
+            grp = f.create_group('/tls/tl' + str(tlindex + 1))
+            grp.attrs['Position'] = (tl.xcoord * G.dx, tl.ycoord * G.dy, tl.zcoord * G.dz)
+            grp.attrs['Resistance'] = tl.resistance
+            grp.attrs['dl'] = tl.dl
+            # Save incident voltage and current
+            grp['Vinc'] = tl.Vinc
+            grp['Iinc'] = tl.Iinc
+            # Save total voltage and current
+            f['/tls/tl' + str(tlindex + 1) + '/Vtotal'] = tl.Vtotal
+            f['/tls/tl' + str(tlindex + 1) + '/Itotal'] = tl.Itotal
+
+    # Create group, add positional data and write field component arrays for receivers
+    for rxindex, rx in enumerate(G.rxs):
+        grp = f.create_group('/rxs/rx' + str(rxindex + 1))
+        if rx.ID:
+            grp.attrs['Name'] = rx.ID
+        grp.attrs['Position'] = (rx.xcoord * G.dx, rx.ycoord * G.dy, rx.zcoord * G.dz)
+
+        if 'Ex' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Ex'] = rx.outputs['Ex']
+        if 'Ey' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Ey'] = rx.outputs['Ey']
+        if 'Ez' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Ez'] = rx.outputs['Ez']
+        if 'Hx' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Hx'] = rx.outputs['Hx']
+        if 'Hy' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Hy'] = rx.outputs['Hy']
+        if 'Hz' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Hz'] = rx.outputs['Hz']
+        if 'Ix' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Ix'] = rx.outputs['Ix']
+        if 'Iy' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Iy'] = rx.outputs['Iy']
+        if 'Iz' in rx.outputs:
+            f['/rxs/rx' + str(rxindex + 1) + '/Iz'] = rx.outputs['Iz']