Dipole

class emg3d.surveys.Dipole(name, coordinates, electric=True, **kwargs)

Bases: emg3d.surveys.PointDipole

Finite length dipole or point dipole.

Expansion of the basic PointDipole to allow for finite length dipoles, and to provide coordinate inputs in the form of (x, y, z, azimuth, dip) or (x0, x1, y0, y1, z0, z1).

Adds attributes is_finite, electrode1, electrode2, length, and coordinates to the class.

For point dipoles, this gives it a length of unity (1 m), takes its coordinates as center, and computes the two electrode positions.

For finite length dipoles it sets the coordinates to its center and computes its length, azimuth, and dip.

Finite length dipoles and point dipoles have therefore the exactly same signature, and can only be distinguished by the attribute is_finite.

Parameters:

name : str

Dipole name.

coordinates : tuple of floats

Source coordinates, one of the following:

• (x0, x1, y0, y1, z0, z1): finite length dipole,
• (x, y, z, azimuth, dip): point dipole.

The coordinates x, y, and z are in meters (m), the azimuth and dip in degree (°).

Angles (coordinate system is right-handed with positive z up; East-North-Depth):

• azimuth (°): horizontal deviation from x-axis, anti-clockwise.
• +/-dip (°): vertical deviation from xy-plane down/up-wards.

electric : bool

Electric dipole if True, magnetic dipole otherwise. Default is True.

Attributes Summary

azm
dip
electric
name
xco
yco
zco

Attributes Documentation

azm

dip

electric

name

xco

yco

zco