gprMax/gprMax/cmds_geometry/triangle.py

# Copyright (C) 2015-2023: The University of Edinburgh, United Kingdom
#                 Authors: Craig Warren, Antonis Giannopoulos, and John Hartley
#
# 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 logging

import numpy as np

from ..cython.geometry_primitives import build_triangle
from ..materials import Material
from .cmds_geometry import UserObjectGeometry, rotate_point

logger = logging.getLogger(__name__)


class Triangle(UserObjectGeometry):
    """Introduces a triangular patch or a triangular prism with specific 
        properties into the model.

    Attributes:
        p1: list of the coordinates (x,y,z) of the first apex of the triangle.
        p2: list of the coordinates (x,y,z) of the second apex of the triangle.
        p3: list of the coordinates (x,y,z) of the third apex of the triangle.
        thickness: float for the thickness of the triangular prism. If the 
                    thickness is zero then a triangular patch is created.
        material_id: string for the material identifier that must correspond 
                        to material that has already been defined.
        material_ids: list of material identifiers in the x, y, z directions.
        averaging: string (y or n) used to switch on and off dielectric smoothing.
    """

    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.hash = '#triangle'

    def rotate(self, axis, angle, origin=None):
        """Sets parameters for rotation."""
        self.axis = axis
        self.angle = angle
        self.origin = origin
        self.do_rotate = True

    def _do_rotate(self):
        """Performs rotation."""
        p1 = rotate_point(self.kwargs['p1'], self.axis, self.angle, self.origin)
        p2 = rotate_point(self.kwargs['p2'], self.axis, self.angle, self.origin)
        p3 = rotate_point(self.kwargs['p3'], self.axis, self.angle, self.origin)
        self.kwargs['p1'] = tuple(p1)
        self.kwargs['p2'] = tuple(p2)
        self.kwargs['p3'] = tuple(p3)

    def create(self, grid, uip):
        try:
            up1 = self.kwargs['p1']
            up2 = self.kwargs['p2']
            up3 = self.kwargs['p3']
            thickness = self.kwargs['thickness']
        except KeyError:
            logger.exception(self.__str__() + ' specify 3 points and a thickness')
            raise
        
        if self.do_rotate:
            self._do_rotate()

        # Check averaging
        try:
            # Try user-specified averaging
            averagetriangularprism = self.kwargs['averaging'] 
        except KeyError:
            # Otherwise go with the grid default
            averagetriangularprism = grid.averagevolumeobjects

        # Check materials have been specified
        # Isotropic case
        try:
            materialsrequested = [self.kwargs['material_id']]
        except KeyError:
            # Anisotropic case
            try:
                materialsrequested = self.kwargs['material_ids']
            except KeyError:
                logger.exception(self.__str__() + ' no materials have been specified')
                raise

        p4 = uip.round_to_grid_static_point(up1)
        p5 = uip.round_to_grid_static_point(up2)
        p6 = uip.round_to_grid_static_point(up3)

        # Check whether points are valid against grid
        uip.check_tri_points(up1, up2, up3, object)
        # Convert points to metres
        x1, y1, z1 = uip.round_to_grid(up1)
        x2, y2, z2 = uip.round_to_grid(up2)
        x3, y3, z3 = uip.round_to_grid(up3)
        
        if thickness < 0:
            logger.exception(self.__str__() + ' requires a positive value for thickness')
            raise ValueError

        # Check for valid orientations
        # yz-plane triangle
        if x1 == x2 and x2 == x3:
            normal = 'x'
        # xz-plane triangle
        elif y1 == y2 and y2 == y3:
            normal = 'y'
        # xy-plane triangle
        elif z1 == z2 and z2 == z3:
            normal = 'z'
        else:
            logger.exception(self.__str__() + ' the triangle is not specified correctly')
            raise ValueError

        # Look up requested materials in existing list of material instances
        materials = [y for x in materialsrequested for y in grid.materials if y.ID == x]

        if len(materials) != len(materialsrequested):
            notfound = [x for x in materialsrequested if x not in materials]
            logger.exception(self.__str__() + f' material(s) {notfound} do not exist')
            raise ValueError

        if thickness > 0:
            # Isotropic case
            if len(materials) == 1:
                averaging = materials[0].averagable and averagetriangularprism
                numID = numIDx = numIDy = numIDz = materials[0].numID

            # Uniaxial anisotropic case
            elif len(materials) == 3:
                averaging = False
                numIDx = materials[0].numID
                numIDy = materials[1].numID
                numIDz = materials[2].numID
                requiredID = materials[0].ID + '+' + materials[1].ID + '+' + materials[2].ID
                averagedmaterial = [x for x in grid.materials if x.ID == requiredID]
                if averagedmaterial:
                    numID = averagedmaterial.numID
                else:
                    numID = len(grid.materials)
                    m = Material(numID, requiredID)
                    m.type = 'dielectric-smoothed'
                    # Create dielectric-smoothed constituents for material
                    m.er = np.mean((materials[0].er, materials[1].er, 
                                    materials[2].er), axis=0)
                    m.se = np.mean((materials[0].se, materials[1].se, 
                                    materials[2].se), axis=0)
                    m.mr = np.mean((materials[0].mr, materials[1].mr, 
                                    materials[2].mr), axis=0)
                    m.sm = np.mean((materials[0].mr, materials[1].mr, 
                                    materials[2].mr), axis=0)

                    # Append the new material object to the materials list
                    grid.materials.append(m)
        else:
            averaging = False
            # Isotropic case
            if len(materials) == 1:
                numID = numIDx = numIDy = numIDz = materials[0].numID

            # Uniaxial anisotropic case
            elif len(materials) == 3:
                # numID requires a value but it will not be used
                numID = None
                numIDx = materials[0].numID
                numIDy = materials[1].numID
                numIDz = materials[2].numID

        build_triangle(x1, y1, z1, x2, y2, z2, x3, y3, z3, normal, thickness, 
                       grid.dx, grid.dy, grid.dz, numID, numIDx, numIDy, numIDz, 
                       averaging, grid.solid, grid.rigidE, grid.rigidH, grid.ID)

        if thickness > 0:
            dielectricsmoothing = 'on' if averaging else 'off'
            logger.info(self.grid_name(grid) + f"Triangle with coordinates " +
                        f"{p4[0]:g}m {p4[1]:g}m {p4[2]:g}m, {p5[0]:g}m {p5[1]:g}m " +
                        f"{p5[2]:g}m, {p6[0]:g}m {p6[1]:g}m {p6[2]:g}m and thickness " +
                        f"{thickness:g}m of material(s) {', '.join(materialsrequested)} " +
                        f"created, dielectric smoothing is {dielectricsmoothing}.")
        else:
            logger.info(self.grid_name(grid) + f"Triangle with coordinates " +
                        f"{p4[0]:g}m {p4[1]:g}m {p4[2]:g}m, {p5[0]:g}m {p5[1]:g}m " +
                        f"{p5[2]:g}m, {p6[0]:g}m {p6[1]:g}m {p6[2]:g}m of material(s) " +
                        f"{', '.join(materialsrequested)} created.")