ProjectedPoint::obliqueMercatorLaborde() - Code Metrics - Inspection of "Drop deprecated data" - dvdoug/PHPCoord - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — 4.x ( e9b635...bc20e1 )

by Doug
created 2020-12-24 20:40 UTC
ProjectedPoint::obliqueMercatorLaborde() A

↳ Parent: ProjectedPoint
Complexity

Conditions	4
Paths	2
Size

Total Lines	59
Code Lines	40
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	36
CRAP Score	4.0023
Importance

Changes
Metric	Value
eloc	40
c	0
b	0
f	0
dl	0
loc	59
ccs	36
cts	38
cp	0.9474
rs	9.28
cc	4
nc	2
nop	7
crap	4.0023
How to fix Long Method

<?php
/**
 * PHPCoord.
 *
 * @author Doug Wright
 */
declare(strict_types=1);

namespace PHPCoord;

use function abs;
use function asin;
use function atan2;
use function cos;
use DateTime;
use DateTimeImmutable;
use DateTimeInterface;
use function implode;
use function log;
use PHPCoord\CoordinateOperation\ComplexNumber;
use PHPCoord\CoordinateReferenceSystem\Geographic;
use PHPCoord\CoordinateReferenceSystem\Projected;
use PHPCoord\CoordinateSystem\Axis;
use PHPCoord\Exception\InvalidAxesException;
use PHPCoord\Exception\InvalidCoordinateReferenceSystemException;
use PHPCoord\Exception\UnknownAxisException;
use PHPCoord\UnitOfMeasure\Angle\Angle;
use PHPCoord\UnitOfMeasure\Angle\ArcSecond;
use PHPCoord\UnitOfMeasure\Angle\Degree;
use PHPCoord\UnitOfMeasure\Angle\Radian;
use PHPCoord\UnitOfMeasure\Length\Length;
use PHPCoord\UnitOfMeasure\Length\Metre;
use PHPCoord\UnitOfMeasure\Scale\Coefficient;
use PHPCoord\UnitOfMeasure\Scale\Scale;
use function sin;
use function sqrt;
use function tan;

/**
 * Coordinate representing a point on a map projection.
 */
class ProjectedPoint extends Point
{
    /**
     * Easting.
     */
    protected Length $easting;

    /**
     * Northing.
     */
    protected Length $northing;

    /**
     * Westing.
     */
    protected Length $westing;

    /**
     * Southing.
     */
    protected Length $southing;

    /**
     * Coordinate reference system.
     */
    protected Projected $crs;

    /**
     * Coordinate epoch (date for which the specified coordinates represented this point).
     */
    protected ?DateTimeImmutable $epoch;

    protected function __construct(?Length $easting, ?Length $northing, ?Length $westing, ?Length $southing, Projected $crs, ?DateTimeInterface $epoch = null)
    {
        $this->crs = $crs;

        $eastingAxis = $this->getAxisByName(Axis::EASTING);
        $westingAxis = $this->getAxisByName(Axis::WESTING);
        $northingAxis = $this->getAxisByName(Axis::NORTHING);
        $southingAxis = $this->getAxisByName(Axis::SOUTHING);

        if ($easting && $eastingAxis) {
            $this->easting = Length::convert($easting, $eastingAxis->getUnitOfMeasureId());
            $this->westing = $this->easting->multiply(-1);
        } elseif ($westing && $westingAxis) {
            $this->westing = Length::convert($westing, $westingAxis->getUnitOfMeasureId());
            $this->easting = $this->westing->multiply(-1);
        } else {
            throw new InvalidAxesException($crs->getCoordinateSystem()->getAxes());
        }

        if ($northing && $northingAxis) {
            $this->northing = Length::convert($northing, $northingAxis->getUnitOfMeasureId());
            $this->southing = $this->northing->multiply(-1);
        } elseif ($southing && $southingAxis) {
            $this->southing = Length::convert($southing, $southingAxis->getUnitOfMeasureId());
            $this->northing = $this->southing->multiply(-1);
        } else {
            throw new InvalidAxesException($crs->getCoordinateSystem()->getAxes());
        }

        if ($epoch instanceof DateTime) {
            $epoch = DateTimeImmutable::createFromMutable($epoch);
        }
        $this->epoch = $epoch;
    }

    public static function create(?Length $easting, ?Length $northing, ?Length $westing, ?Length $southing, Projected $crs, ?DateTimeInterface $epoch = null): self
    {
        if ($crs->getSRID() === Projected::EPSG_OSGB_1936_BRITISH_NATIONAL_GRID) {
            return new BritishNationalGridPoint($easting, $northing, $epoch);
            return new BritishNationalGridPoint(/** @scrutinizer ignore-type */ $easting, $northing, $epoch);
        }

        if ($crs->getSRID() === Projected::EPSG_TM75_IRISH_GRID) {
            return new IrishGridPoint($easting, $northing, $epoch);
            return new IrishGridPoint(/** @scrutinizer ignore-type */ $easting, $northing, $epoch);
        }

        if ($crs->getSRID() === Projected::EPSG_IRENET95_IRISH_TRANSVERSE_MERCATOR) {
            return new IrishTransverseMercatorPoint($easting, $northing, $epoch);
            return new IrishTransverseMercatorPoint(/** @scrutinizer ignore-type */ $easting, $northing, $epoch);
        }

        return new static($easting, $northing, $westing, $southing, $crs, $epoch);
    }

    public static function createFromEastingNorthing(?Length $easting, ?Length $northing, Projected $crs, ?DateTimeInterface $epoch = null): self
    {
        return static::create($easting, $northing, null, null, $crs, $epoch);
    }

    public static function createFromWestingNorthing(?Length $westing, ?Length $northing, Projected $crs, ?DateTimeInterface $epoch = null): self
    {
        return static::create(null, $northing, $westing, null, $crs, $epoch);
    }

    public static function createFromWestingSouthing(?Length $westing, ?Length $southing, Projected $crs, ?DateTimeInterface $epoch = null): self
    {
        return static::create(null, null, $westing, $southing, $crs, $epoch);
    }

    public function getEasting(): Length
    {
        return $this->easting;
    }

    public function getNorthing(): Length
    {
        return $this->northing;
    }

    public function getWesting(): Length
    {
        return $this->westing;
    }

    public function getSouthing(): Length
    {
        return $this->southing;
    }

    public function getCRS(): Projected
    {
        return $this->crs;
    }

    public function getCoordinateEpoch(): ?DateTimeImmutable
    {
        return $this->epoch;
    }

    /**
     * Calculate distance between two points.
     * Because this is a simple grid, we can use Pythagoras.
     */
    public function calculateDistance(Point $to): Length
    {
        if ($to->getCRS()->getSRID() !== $this->crs->getSRID()) {
            throw new InvalidCoordinateReferenceSystemException('Can only calculate distances between two points in the same CRS');
        }

        /* @var ProjectedPoint $to */
        return new Metre(
            sqrt(
                ($to->getEasting()->getValue() - $this->getEasting()->getValue()) ** 2 +
                ($to->getNorthing()->getValue() - $this->getNorthing()->getValue()) ** 2
            )
        );
    }

    public function __toString(): string
    {
        $values = [];
        foreach ($this->getCRS()->getCoordinateSystem()->getAxes() as $axis) {
            if ($axis->getName() === Axis::EASTING) {
                $values[] = $this->easting;
            } elseif ($axis->getName() === Axis::NORTHING) {
                $values[] = $this->northing;
            } elseif ($axis->getName() === Axis::WESTING) {
                $values[] = $this->westing;
            } elseif ($axis->getName() === Axis::SOUTHING) {
                $values[] = $this->southing;
            } else {
                throw new UnknownAxisException(); // @codeCoverageIgnore
            }
        }

        return '(' . implode(', ', $values) . ')';
    }

    /**
     * Affine parametric transformation.
     */
    public function affineParametricTransform(
        Projected $to,
        Length $coefficientA0,
        Coefficient $coefficientA1,
        Coefficient $coefficientA2,
        Length $coefficientB0,
        Coefficient $coefficientB1,
        Coefficient $coefficientB2
    ): self {
        $xs = $this->easting->getValue(); // native unit to metre conversion already embedded in the scale factor
        $ys = $this->northing->getValue(); // native unit to metre conversion already embedded in the scale factor
        $a0 = $coefficientA0->asMetres()->getValue();
        $a1 = $coefficientA1->getValue();
        $a2 = $coefficientA2->getValue();
        $b0 = $coefficientB0->asMetres()->getValue();
        $b1 = $coefficientB1->getValue();
        $b2 = $coefficientB2->getValue();

        $xt = $a0 + ($a1 * $xs) + ($a2 * $ys);
        $yt = $b0 + ($b1 * $xs) + ($b2 * $ys);

        return static::create(new Metre($xt), new Metre($yt), new Metre(-$xt), new Metre(-$yt), $to, $this->epoch);
    }

    /**
     * Albers Equal Area.
     */
    public function albersEqualArea(
        Geographic $to,
        Angle $falseOriginLatitude,
        Angle $falseOriginLongitude,
        Angle $firstStandardParallellLatitude,
        Angle $secondStandardParallellLatitude,
        Length $falseOriginEasting,
        Length $falseOriginNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseOriginEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue();
        $phiOrigin = $falseOriginLatitude->asRadians()->getValue();
        $phi1 = $firstStandardParallellLatitude->asRadians()->getValue();
        $phi2 = $secondStandardParallellLatitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $e ** 4;
        $e6 = $e ** 6;

        $centralMeridianFirstParallel = cos($phi1) / sqrt(1 - $e2 * sin($phi1) ** 2);
        $centralMeridianSecondParallel = cos($phi2) / sqrt(1 - $e2 * sin($phi2) ** 2);

        $alphaOrigin = (1 - $e2) * (sin($phiOrigin) / (1 - $e2 * sin($phiOrigin) ** 2) - (1 / 2 / $e) * log((1 - $e * sin($phiOrigin)) / (1 + $e * sin($phiOrigin))));
        $alphaFirstParallel = (1 - $e2) * (sin($phi1) / (1 - $e2 * sin($phi1) ** 2) - (1 / 2 / $e) * log((1 - $e * sin($phi1)) / (1 + $e * sin($phi1))));
        $alphaSecondParallel = (1 - $e2) * (sin($phi2) / (1 - $e2 * sin($phi2) ** 2) - (1 / 2 / $e) * log((1 - $e * sin($phi2)) / (1 + $e * sin($phi2))));

        $n = ($centralMeridianFirstParallel ** 2 - $centralMeridianSecondParallel ** 2) / ($alphaSecondParallel - $alphaFirstParallel);
        $C = $centralMeridianFirstParallel ** 2 + $n * $alphaFirstParallel;
        $rhoOrigin = $a * sqrt($C - $n * $alphaOrigin) / $n;
        $rhoPrime = sqrt($easting ** 2 + ($rhoOrigin - $northing) ** 2);
        $alphaPrime = ($C - $rhoPrime ** 2 * $n ** 2 / $a ** 2) / $n;
        $betaPrime = asin($alphaPrime / (1 - (1 - $e2) / 2 / $e * log((1 - $e) / (1 + $e))));
        if ($n > 0) {
            $theta = atan2($easting, $rhoOrigin - $northing);
        } else {
            $theta = atan2(-$easting, $northing - $rhoOrigin);
        }

        $latitude = $betaPrime + (($e2 / 3 + 31 * $e4 / 180 + 517 * $e6 / 5040) * sin(2 * $betaPrime)) + ((23 * $e4 / 360 + 251 * $e6 / 3780) * sin(4 * $betaPrime)) + ((761 * $e6 / 45360) * sin(6 * $betaPrime));
        $longitude = $falseOriginLongitude->asRadians()->getValue() + ($theta / $n);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * American Polyconic.
     */
    public function americanPolyconic(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();

        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $i = (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256);
        $ii = (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024);
        $iii = (15 * $e4 / 256 + 45 * $e6 / 1024);
        $iv = (35 * $e6 / 3072);

        $MO = $a * ($i * $latitudeOrigin - $ii * sin(2 * $latitudeOrigin) + $iii * sin(4 * $latitudeOrigin) - $iv * sin(6 * $latitudeOrigin));

        if ($MO === $northing) {
            $latitude = 0;
            $longitude = $longitudeOrigin + $easting / $a;
        } else {
            $A = ($MO + $northing) / $a;
            $B = $A ** 2 + $easting ** 2 / $a ** 2;

            $latitude = $A;
            do {
                $latitudeN = $latitude;
                $M = $a * ($i * $latitude - $ii * sin(2 * $latitude) + $iii * sin(4 * $latitude) - $iv * sin(6 * $latitude));
                $C = sqrt(1 - $e2 * sin($latitude) ** 2) * tan($latitude);
                $J = $M / $a;
                $latitude = $latitude - ($A * ($C * $J + 1) - $J - $C * ($J ** 2 + $B) / 2) / ($e2 * sin(2 * $latitude) * ($J ** 2 + $B - 2 * $A * $J) / 4 * $C + ($A - $J) * ($C * $M - (2 / sin(2 * $latitude)) - $M));
            } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

            $longitude = $longitudeOrigin + (asin($easting * $C / $a)) / sin($latitude);
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Bonne.
     */
    public function bonne(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $e ** 4;
        $e6 = $e ** 6;

        $mO = cos($latitudeOrigin) / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2);
        $MO = $a * ((1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256) * $latitudeOrigin - (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024) * sin(2 * $latitudeOrigin) + (15 * $e4 / 256 + 45 * $e6 / 1024) * sin(4 * $latitudeOrigin) - (35 * $e6 / 3072) * sin(6 * $latitudeOrigin));
        $rho = sqrt($easting ** 2 + ($a * $mO / sin($latitudeOrigin) - $northing) ** 2) * static::sign($latitudeOrigin);

        $M = $a * $mO / sin($latitudeOrigin) + $MO - $rho;
        $mu = $M / ($a * (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256));
        $e1 = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));

        $latitude = $mu + ((3 * $e1 / 2) - (27 * $e1 ** 3 / 32)) * sin(2 * $mu) + ((21 * $e1 ** 2 / 16) - (55 * $e1 ** 4 / 32)) * sin(4 * $mu) + ((151 * $e1 ** 3 / 96)) * sin(6 * $mu) + ((1097 * $e1 ** 4 / 512)) * sin(8 * $mu);
        $m = cos($latitude) / sqrt(1 - $e2 * sin($latitude) ** 2);

        if ($m === 0) {
            $longitude = $longitudeOrigin; // pole
        } elseif ($latitudeOrigin >= 0) {
            $longitude = $longitudeOrigin + $rho * atan2($easting, $a * $mO / sin($latitudeOrigin) - $northing) / $a / $m;
        } else {
            $longitude = $longitudeOrigin + $rho * atan2(-$easting, -($a * $mO / sin($latitudeOrigin) - $northing)) / $a / $m;
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Bonne South Orientated.
     */
    public function bonneSouthOrientated(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $westing = $falseEasting->asMetres()->getValue() - $this->westing->asMetres()->getValue();
        $southing = $falseNorthing->asMetres()->getValue() - $this->southing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $e ** 4;
        $e6 = $e ** 6;

        $mO = cos($latitudeOrigin) / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2);
        $MO = $a * ((1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256) * $latitudeOrigin - (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024) * sin(2 * $latitudeOrigin) + (15 * $e4 / 256 + 45 * $e6 / 1024) * sin(4 * $latitudeOrigin) - (35 * $e6 / 3072) * sin(6 * $latitudeOrigin));
        $rho = sqrt($westing ** 2 + ($a * $mO / sin($latitudeOrigin) - $southing) ** 2) * static::sign($latitudeOrigin);

        $M = $a * $mO / sin($latitudeOrigin) + $MO - $rho;
        $mu = $M / ($a * (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256));
        $e1 = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));

        $latitude = $mu + ((3 * $e1 / 2) - (27 * $e1 ** 3 / 32)) * sin(2 * $mu) + ((21 * $e1 ** 2 / 16) - (55 * $e1 ** 4 / 32)) * sin(4 * $mu) + ((151 * $e1 ** 3 / 96)) * sin(6 * $mu) + ((1097 * $e1 ** 4 / 512)) * sin(8 * $mu);
        $m = cos($latitude) / sqrt(1 - $e2 * sin($latitude) ** 2);

        if ($m === 0) {
            $longitude = $longitudeOrigin; // pole
        } elseif ($latitudeOrigin >= 0) {
            $longitude = $longitudeOrigin + $rho * atan2($westing, $a * $mO / sin($latitudeOrigin) - $southing) / $a / $m;
        } else {
            $longitude = $longitudeOrigin + $rho * atan2(-$westing, -($a * $mO / sin($latitudeOrigin) - $southing)) / $a / $m;
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Cartesian Grid Offsets
     * This transformation allows calculation of coordinates in the target system by adding the parameter value to the
     * coordinate values of the point in the source system.
     */
    public function offsets(
        Projected $to,
        Length $eastingOffset,
        Length $northingOffset
    ): self {
        $easting = $this->easting->asMetres()->getValue() + $eastingOffset->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() + $northingOffset->asMetres()->getValue();

        return static::create(new Metre($easting), new Metre($northing), new Metre(-$easting), new Metre(-$northing), $to, $this->epoch);
    }

    /**
     * Cassini-Soldner.
     */
    public function cassiniSoldner(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $MO = $a * ((1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256) * $latitudeOrigin - (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024) * sin(2 * $latitudeOrigin) + (15 * $e4 / 256 + 45 * $e6 / 1024) * sin(4 * $latitudeOrigin) - (35 * $e6 / 3072) * sin(6 * $latitudeOrigin));

        $e1 = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));
        $M = $MO + $northing;
        $mu = $M / ($a * (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256));
        $latitudeCentralMeridian = $mu + (3 * $e1 / 2 - 27 * $e1 ** 3 / 32) * sin(2 * $mu) + (21 * $e1 ** 2 / 16 - 55 * $e1 ** 4 / 32) * sin(4 * $mu) + (151 * $e1 ** 3 / 96) * sin(6 * $mu) + (1097 * $e1 ** 4 / 512) * sin(8 * $mu);

        $nu = $a / sqrt((1 - $e2 * sin($latitudeCentralMeridian) ** 2));
        $rho = $a * (1 - $e2) / (1 - $e2 * sin($latitudeCentralMeridian) ** 2) ** 1.5;

        $T = tan($latitudeCentralMeridian) ** 2;
        $D = $easting / $nu;

        $latitude = $latitudeCentralMeridian - ($nu * tan($latitudeCentralMeridian) / $rho) * ($D ** 2 / 2 - (1 + 3 * $T) * $D ** 4 / 24);
        $longitude = $longitudeOrigin + ($D - $T * $D ** 3 / 3 + (1 + 3 * $T) * $T * $D ** 5 / 15) / cos($latitudeCentralMeridian);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Hyperbolic Cassini-Soldner.
     */
    public function hyperbolicCassiniSoldner(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $MO = $a * ((1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256) * $latitudeOrigin - (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024) * sin(2 * $latitudeOrigin) + (15 * $e4 / 256 + 45 * $e6 / 1024) * sin(4 * $latitudeOrigin) - (35 * $e6 / 3072) * sin(6 * $latitudeOrigin));
        $e1 = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));

        $latitude1 = $latitudeOrigin + $northing / 1567446;

        $nu = $a / sqrt((1 - $e2 * sin($latitude1) ** 2));
        $rho = $a * (1 - $e2) / (1 - $e2 * sin($latitude1) ** 2) ** 1.5;

        $qPrime = $northing ** 3 / (6 * $rho * $nu);
        $q = ($northing + $qPrime) ** 3 / (6 * $rho * $nu);
        $M = $MO + $northing + $q;

        $mu = $M / ($a * (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256));
        $latitudeCentralMeridian = $mu + (3 * $e1 / 2 - 27 * $e1 ** 3 / 32) * sin(2 * $mu) + (21 * $e1 ** 2 / 16 - 55 * $e1 ** 4 / 32) * sin(4 * $mu) + (151 * $e1 ** 3 / 96) * sin(6 * $mu) + (1097 * $e1 ** 4 / 512) * sin(8 * $mu);

        $T = tan($latitudeCentralMeridian) ** 2;
        $D = $easting / $nu;

        $latitude = $latitudeCentralMeridian - ($nu * tan($latitudeCentralMeridian) / $rho) * ($D ** 2 / 2 - (1 + 3 * $T) * $D ** 4 / 24);
        $longitude = $longitudeOrigin + ($D - $T * $D ** 3 / 3 + (1 + 3 * $T) * $T * $D ** 5 / 15) / cos($latitudeCentralMeridian);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Colombia Urban.
     */
    public function columbiaUrban(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing,
        Length $projectionPlaneOriginHeight
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $heightOrigin = $projectionPlaneOriginHeight->asMetres()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $rhoOrigin = $a * (1 - $e2) / (1 - $e2 * sin($latitudeOrigin) ** 2) ** 1.5;

        $nuOrigin = $a / sqrt(1 - $e2 * (sin($latitudeOrigin) ** 2));

        $B = tan($latitudeOrigin) / (2 * $rhoOrigin * $nuOrigin);
        $C = 1 + $heightOrigin / $a;
        $D = $rhoOrigin * (1 + $heightOrigin / ($a * (1 - $e2)));

        $latitude = $latitudeOrigin + ($northing / $D) - $B * ($easting / $C) ** 2;
        $nu = $a / sqrt(1 - $e2 * (sin($latitude) ** 2));
        $longitude = $longitudeOrigin + $easting / ($C * $nu * cos($latitude));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Equal Earth.
     */
    public function equalEarth(
        Geographic $to,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $e ** 4;
        $e6 = $e ** 6;

        $qP = (1 - $e2) * ((1 / (1 - $e2)) - (1 / (2 * $e) * log((1 - $e) / (1 + $e))));
        $Rq = $a * sqrt($qP / 2);

        $theta = $northing / $Rq;
        do {
            $thetaN = $theta;
            $correctionFactor = ($theta * (1.340264 - 0.081106 * $theta ** 2 + $theta ** 6 * (0.000893 + 0.003796 * $theta ** 2)) - $northing / $Rq) / (1.340264 - 0.243318 * $theta ** 2 + $theta ** 6 * (0.006251 + 0.034164 * $theta ** 2));
            $theta = $theta - $correctionFactor;
        } while (abs($theta - $thetaN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $beta = asin(2 * sin($theta) / sqrt(3));

        $latitude = $beta + (($e2 / 3 + 31 * $e4 / 180 + 517 * $e6 / 5040) * sin(2 * $beta)) + ((23 * $e4 / 360 + 251 * $e6 / 3780) * sin(4 * $beta)) + ((761 * $e6 / 45360) * sin(6 * $beta));
        $longitude = $longitudeOrigin + sqrt(3) * $easting * (1.340264 - 0.243318 * $theta ** 2 + $theta ** 6 * (0.006251 + 0.034164 * $theta ** 2)) / (2 * $Rq * cos($theta));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Equidistant Cylindrical
     * See method code 1029 for spherical development. See also Pseudo Plate Carree, method code 9825.
     */
    public function equidistantCylindrical(
        Geographic $to,
        Angle $firstStandardParallelLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeFirstParallel = $firstStandardParallelLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $e ** 4;
        $e6 = $e ** 6;
        $e8 = $e ** 8;
        $e10 = $e ** 10;
        $e12 = $e ** 12;
        $e14 = $e ** 14;

        $n = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));
        $n2 = $n ** 2;
        $n3 = $n ** 3;
        $n4 = $n ** 4;
        $n5 = $n ** 5;
        $n6 = $n ** 6;
        $n7 = $n ** 7;
        $mu = $northing / ($a * (1 - 1 / 4 * $e2 - 3 / 64 * $e4 - 5 / 256 * $e6 - 175 / 16384 * $e8 - 441 / 65536 * $e10 - 4851 / 1048576 * $e12 - 14157 / 4194304 * $e14));

        $latitude = $mu + (3 / 2 * $n - 27 / 32 * $n3 + 269 / 512 * $n5 - 6607 / 24576 * $n7) * sin(2 * $mu)
            + (21 / 16 * $n2 - 55 / 32 * $n4 + 6759 / 4096 * $n6) * sin(4 * $mu)
            + (151 / 96 * $n3 - 417 / 128 * $n5 + 87963 / 20480 * $n7) * sin(6 * $mu)
            + (1097 / 512 * $n4 - 15543 / 2560 * $n6) * sin(8 * $mu)
            + (8011 / 2560 * $n5 - 69119 / 6144 * $n7) * sin(10 * $mu)
            + (293393 / 61440 * $n6) * sin(12 * $mu)
            + (6845701 / 860160 * $n7) * sin(14 * $mu);

        $longitude = $longitudeOrigin + $easting * sqrt(1 - $e2 * sin($latitudeFirstParallel) ** 2) / ($a * cos($latitudeFirstParallel));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Guam Projection
     * Simplified form of Oblique Azimuthal Equidistant projection method.
     */
    public function guamProjection(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $MO = $a * ((1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256) * $latitudeOrigin - (3 * $e2 / 8 + 3 * $e4 / 32 + 45 * $e6 / 1024) * sin(2 * $latitudeOrigin) + (15 * $e4 / 256 + 45 * $e6 / 1024) * sin(4 * $latitudeOrigin) - (35 * $e6 / 3072) * sin(6 * $latitudeOrigin));
        $e1 = (1 - sqrt(1 - $e2)) / (1 + sqrt(1 - $e2));
        $i = (1 - $e2 / 4 - 3 * $e4 / 64 - 5 * $e6 / 256);

        $latitude = $latitudeOrigin;
        do {
            $latitudeN = $latitude;
            $M = $MO + $northing - ($easting ** 2 * tan($latitude) * sqrt(1 - $e2 * sin($latitude) ** 2) / (2 * $a));
            $mu = $M / ($a * $i);
            $latitude = $mu + (3 * $e1 / 2 - 27 * $e1 ** 3 / 32) * sin(2 * $mu) + (21 * $e1 ** 2 / 16 - 55 * $e1 ** 4 / 32) * sin(4 * $mu) + (151 * $e1 ** 3 / 96) * sin(6 * $mu) + (1097 * $e1 ** 4 / 512) * sin(8 * $mu);
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $longitudeOrigin + $easting * sqrt(1 - $e2 * sin($latitude) ** 2) / $a * cos($latitude);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Krovak.
     */
    public function krovak(
        Geographic $to,
        Angle $latitudeProjectionCentre,
        Angle $longitudeOrigin,
        Angle $coLatitudeConeAxis,
        Angle $latitudePseudoStandardParallel,
        Scale $scaleFactorPseudoStandardParallel,
        Length $falseWesting,
        Length $falseSouthing
    ): GeographicPoint {
        $longitudeOffset = $this->crs->getDatum()->getPrimeMeridian()->getGreenwichLongitude()->asRadians()->getValue() - $to->getDatum()->getPrimeMeridian()->getGreenwichLongitude()->asRadians()->getValue();
        $westing = $this->westing->asMetres()->getValue() - $falseWesting->asMetres()->getValue();
        $southing = $this->southing->asMetres()->getValue() - $falseSouthing->asMetres()->getValue();
        $latitudeC = $latitudeProjectionCentre->asRadians()->getValue();
        $longitudeO = $longitudeOrigin->asRadians()->getValue();
        $alphaC = $coLatitudeConeAxis->asRadians()->getValue();
        $latitudeP = $latitudePseudoStandardParallel->asRadians()->getValue();
        $kP = $scaleFactorPseudoStandardParallel->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $A = $a * sqrt(1 - $e2) / (1 - $e2 * sin($latitudeC) ** 2);
        $B = sqrt(1 + $e2 * cos($latitudeC) ** 4 / (1 - $e2));
        $upsilonO = asin(sin($latitudeC) / $B);
        $tO = tan(M_PI / 4 + $upsilonO / 2) * ((1 + $e * sin($latitudeC)) / (1 - $e * sin($latitudeC))) ** ($e * $B / 2) / (tan(M_PI / 4 + $latitudeC / 2) ** $B);
        $n = sin($latitudeP);
        $rO = $kP * $A / tan($latitudeP);

        $r = sqrt($southing ** 2 + $westing ** 2);
        $theta = atan2($westing, $southing);
        $D = $theta / sin($latitudeP);
        $T = 2 * (atan(($rO / $r) ** (1 / $n) * tan(M_PI / 4 + $latitudeP / 2)) - M_PI / 4);
        $U = asin(cos($alphaC) * sin($T) - sin($alphaC) * cos($T) * cos($D));
        $V = asin(cos($T) * sin($D) / cos($U));

        $latitude = $U;
        do {
            $latitudeN = $latitude;
            $latitude = 2 * (atan($tO ** (-1 / $B) * tan($U / 2 + M_PI / 4) ** (1 / $B) * ((1 + $e * sin($latitude)) / (1 - $e * sin($latitude))) ** ($e / 2)) - M_PI / 4);
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $longitudeO + $longitudeOffset - $V / $B;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Krovak Modified
     * Incorporates a polynomial transformation which is defined to be exact and for practical purposes is considered
     * to be a map projection.
     */
    public function krovakModified(
        Geographic $to,
        Angle $latitudeProjectionCentre,
        Angle $longitudeOrigin,
        Angle $coLatitudeConeAxis,
        Angle $latitudePseudoStandardParallel,
        Scale $scaleFactorPseudoStandardParallel,
        Length $falseWesting,
        Length $falseSouthing,
        Length $evaluationPointSouthing,
        Length $evaluationPointWesting,
        Coefficient $C1,
        Coefficient $C2,
        Coefficient $C3,
        Coefficient $C4,
        Coefficient $C5,
        Coefficient $C6,
        Coefficient $C7,
        Coefficient $C8,
        Coefficient $C9,
        Coefficient $C10
    ): GeographicPoint {
        $Xr = $this->getSouthing()->asMetres()->getValue() - $falseSouthing->asMetres()->getValue() - $evaluationPointSouthing->asMetres()->getValue();
        $Yr = $this->getWesting()->asMetres()->getValue() - $falseWesting->asMetres()->getValue() - $evaluationPointWesting->asMetres()->getValue();
        $c1 = $C1->asUnity()->getValue();
        $c2 = $C2->asUnity()->getValue();
        $c3 = $C3->asUnity()->getValue();
        $c4 = $C4->asUnity()->getValue();
        $c5 = $C5->asUnity()->getValue();
        $c6 = $C6->asUnity()->getValue();
        $c7 = $C7->asUnity()->getValue();
        $c8 = $C8->asUnity()->getValue();
        $c9 = $C9->asUnity()->getValue();
        $c10 = $C10->asUnity()->getValue();

        $dX = $c1 + $c3 * $Xr - $c4 * $Yr - 2 * $c6 * $Xr * $Yr + $c5 * ($Xr ** 2 - $Yr ** 2) + $c7 * $Xr * ($Xr ** 2 - 3 * $Yr ** 2) - $c8 * $Yr * (3 * $Xr ** 2 - $Yr ** 2) + 4 * $c9 * $Xr * $Yr * ($Xr ** 2 - $Yr ** 2) + $c10 * ($Xr ** 4 + $Yr ** 4 - 6 * $Xr ** 2 * $Yr ** 2);
        $dY = $c2 + $c3 * $Yr + $c4 * $Xr + 2 * $c5 * $Xr * $Yr + $c6 * ($Xr ** 2 - $Yr ** 2) + $c8 * $Xr * ($Xr ** 2 - 3 * $Yr ** 2) + $c7 * $Yr * (3 * $Xr ** 2 - $Yr ** 2) - 4 * $c10 * $Xr * $Yr * ($Xr ** 2 - $Yr ** 2) + $c9 * ($Xr ** 4 + $Yr ** 4 - 6 * $Xr ** 2 * $Yr ** 2);

        $Xp = $this->getSouthing()->asMetres()->getValue() - $falseSouthing->asMetres()->getValue() + $dX;
        $Yp = $this->getWesting()->asMetres()->getValue() - $falseWesting->asMetres()->getValue() + $dY;

        $asKrovak = self::create(new Metre(-$Yp), new Metre(-$Xp), new Metre($Yp), new Metre($Xp), $this->crs, $this->epoch);

        return $asKrovak->krovak($to, $latitudeProjectionCentre, $longitudeOrigin, $coLatitudeConeAxis, $latitudePseudoStandardParallel, $scaleFactorPseudoStandardParallel, new Metre(0), new Metre(0));
    }

    /**
     * Lambert Azimuthal Equal Area
     * This is the ellipsoidal form of the projection.
     */
    public function lambertAzimuthalEqualArea(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $qO = (1 - $e2) * ((sin($latitudeOrigin) / (1 - $e2 * sin($latitudeOrigin) ** 2)) - ((1 / (2 * $e)) * log((1 - $e * sin($latitudeOrigin)) / (1 + $e * sin($latitudeOrigin)))));
        $qP = (1 - $e2) * ((1 / (1 - $e2)) - ((1 / (2 * $e)) * log((1 - $e) / (1 + $e))));
        $betaO = asin($qO / $qP);
        $Rq = $a * sqrt($qP / 2);
        $D = $a * (cos($latitudeOrigin) / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2)) / ($Rq * cos($betaO));
        $rho = sqrt(($easting / $D) ** 2 + ($D * $northing) ** 2);
        $C = 2 * asin($rho / (2 * $Rq));
        $beta = asin(cos($C) * sin($betaO) + ($D * $northing * sin($C) * cos($betaO)) / $rho);

        $latitude = $beta + (($e2 / 3 + 31 * $e4 / 180 + 517 * $e6 / 5040) * sin(2 * $beta)) + ((23 * $e4 / 360 + 251 * $e6 / 3780) * sin(4 * $beta)) + ((761 * $e6 / 45360) * sin(6 * $beta));
        $longitude = $longitudeOrigin + atan2($easting * sin($C), $D * $rho * cos($betaO) * cos($C) - $D ** 2 * $northing * sin($betaO) * sin($C));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Azimuthal Equal Area (Spherical)
     * This is the spherical form of the projection.  See coordinate operation method Lambert Azimuthal Equal Area
     * (code 9820) for ellipsoidal form.  Differences of several tens of metres result from comparison of the two
     * methods.
     */
    public function lambertAzimuthalEqualAreaSpherical(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();

        $rho = sqrt($easting ** 2 + $northing ** 2);
        $c = 2 * asin($rho / (2 * $a));

        $latitude = asin(cos($c) * sin($latitudeOrigin) + ($northing * sin($c) * cos($latitudeOrigin) / $rho));

        if ($latitudeOrigin === 90) {

            $longitude = $longitudeOrigin + atan($easting / -$northing);
        } elseif ($latitudeOrigin === -90) {

            $longitude = $longitudeOrigin + atan($easting / $northing);
        } else {
            $longitudeDenominator = ($rho * cos($latitudeOrigin) * cos($c) - $northing * sin($latitudeOrigin) * sin($c));
            $longitude = $longitudeOrigin + atan($easting * sin($c) / $longitudeDenominator);
            if ($longitudeDenominator < 0) {
                $longitude += M_PI;
            }
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Conformal (1SP).
     */
    public function lambertConicConformal1SP(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $mO = cos($latitudeOrigin) / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2);
        $tO = tan(M_PI / 4 - $latitudeOrigin / 2) / ((1 - $e * sin($latitudeOrigin)) / (1 + $e * sin($latitudeOrigin))) ** ($e / 2);
        $n = sin($latitudeOrigin);
        $F = $mO / ($n * $tO ** $n);
        $rO = $a * $F * $tO ** $n ** $scaleFactorOrigin;
        $r = sqrt($easting ** 2 + ($rO - $northing) ** 2);
        if ($n >= 0) {
            $theta = atan2($easting, $rO - $northing);
        } else {
            $r = -$r;
            $theta = atan2(-$easting, -($rO - $northing));
        }

        $t = ($r / ($a * $scaleFactorOrigin * $F)) ** (1 / $n);

        $latitude = M_PI / (2 - 2 * atan($t));
        do {
            $latitudeN = $latitude;
            $latitude = M_PI / 2 - 2 * atan($t * ((1 - $e * sin($latitude)) / (1 + $e * sin($latitude))) ** ($e / 2));
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $theta / $n + $longitudeOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Conformal (1SP).
     */
    public function lambertConicConformalWestOrientated(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $westing = $falseEasting->asMetres()->getValue() - $this->westing->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $mO = cos($latitudeOrigin) / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2);
        $tO = tan(M_PI / 4 - $latitudeOrigin / 2) / ((1 - $e * sin($latitudeOrigin)) / (1 + $e * sin($latitudeOrigin))) ** ($e / 2);
        $n = sin($latitudeOrigin);
        $F = $mO / ($n * $tO ** $n);
        $rO = $a * $F * $tO ** $n ** $scaleFactorOrigin;
        $r = sqrt($westing ** 2 + ($rO - $northing) ** 2);
        if ($n >= 0) {
            $theta = atan2($westing, $rO - $northing);
        } else {
            $r = -$r;
            $theta = atan2(-$westing, -($rO - $northing));
        }

        $t = ($r / ($a * $scaleFactorOrigin * $F)) ** (1 / $n);

        $latitude = M_PI / (2 - 2 * atan($t));
        do {
            $latitudeN = $latitude;
            $latitude = M_PI / 2 - 2 * atan($t * ((1 - $e * sin($latitude)) / (1 + $e * sin($latitude))) ** ($e / 2));
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $theta / $n + $longitudeOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Conformal (2SP).
     */
    public function lambertConicConformal2SP(
        Geographic $to,
        Angle $falseOriginLatitude,
        Angle $falseOriginLongitude,
        Angle $firstStandardParallellLatitude,
        Angle $secondStandardParallellLatitude,
        Length $falseOriginEasting,
        Length $falseOriginNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseOriginEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue();
        $lambdaOrigin = $falseOriginLongitude->asRadians()->getValue();
        $phiF = $falseOriginLatitude->asRadians()->getValue();
        $phi1 = $firstStandardParallellLatitude->asRadians()->getValue();
        $phi2 = $secondStandardParallellLatitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $m1 = cos($phi1) / sqrt(1 - $e2 * sin($phi1) ** 2);
        $m2 = cos($phi2) / sqrt(1 - $e2 * sin($phi2) ** 2);
        $t1 = tan(M_PI / 4 - $phi1 / 2) / ((1 - $e * sin($phi1)) / (1 + $e * sin($phi1))) ** ($e / 2);
        $t2 = tan(M_PI / 4 - $phi2 / 2) / ((1 - $e * sin($phi2)) / (1 + $e * sin($phi2))) ** ($e / 2);
        $tF = tan(M_PI / 4 - $phiF / 2) / ((1 - $e * sin($phiF)) / (1 + $e * sin($phiF))) ** ($e / 2);
        $n = (log($m1) - log($m2)) / (log($t1) - log($t2));
        $F = $m1 / ($n * $t1 ** $n);
        $rF = $a * $F * $tF ** $n;
        $r = sqrt($easting ** 2 + ($rF - $northing) ** 2) * static::sign($n);
        $t = ($r / ($a * $F)) ** (1 / $n);
        if ($n >= 0) {
            $theta = atan2($easting, $rF - $northing);
        } else {
            $theta = atan2(-$easting, -($rF - $northing));
        }

        $latitude = M_PI / 2 - 2 * atan($t);
        do {
            $latitudeN = $latitude;
            $latitude = M_PI / 2 - 2 * atan($t * ((1 - $e * sin($latitude)) / (1 + $e * sin($latitude))) ** ($e / 2));
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $theta / $n + $lambdaOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Conformal (2SP Michigan).
     */
    public function lambertConicConformal2SPMichigan(
        Geographic $to,
        Angle $falseOriginLatitude,
        Angle $falseOriginLongitude,
        Angle $firstStandardParallellLatitude,
        Angle $secondStandardParallellLatitude,
        Length $falseOriginEasting,
        Length $falseOriginNorthing,
        Scale $scalingFactor
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseOriginEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue();
        $lambdaOrigin = $falseOriginLongitude->asRadians()->getValue();
        $phiF = $falseOriginLatitude->asRadians()->getValue();
        $phi1 = $firstStandardParallellLatitude->asRadians()->getValue();
        $phi2 = $secondStandardParallellLatitude->asRadians()->getValue();
        $K = $scalingFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $m1 = cos($phi1) / sqrt(1 - $e2 * sin($phi1) ** 2);
        $m2 = cos($phi2) / sqrt(1 - $e2 * sin($phi2) ** 2);
        $t1 = tan(M_PI / 4 - $phi1 / 2) / ((1 - $e * sin($phi1)) / (1 + $e * sin($phi1))) ** ($e / 2);
        $t2 = tan(M_PI / 4 - $phi2 / 2) / ((1 - $e * sin($phi2)) / (1 + $e * sin($phi2))) ** ($e / 2);
        $tF = tan(M_PI / 4 - $phiF / 2) / ((1 - $e * sin($phiF)) / (1 + $e * sin($phiF))) ** ($e / 2);
        $n = (log($m1) - log($m2)) / (log($t1) - log($t2));
        $F = $m1 / ($n * $t1 ** $n);
        $rF = $a * $K * $F * $tF ** $n;
        $r = sqrt($easting ** 2 + ($rF - $northing) ** 2) * static::sign($n);
        $t = ($r / ($a * $K * $F)) ** (1 / $n);
        if ($n >= 0) {
            $theta = atan2($easting, $rF - $northing);
        } else {
            $theta = atan2(-$easting, -($rF - $northing));
        }

        $latitude = M_PI / 2 - 2 * atan($t);
        do {
            $latitudeN = $latitude;
            $latitude = M_PI / 2 - 2 * atan($t * ((1 - $e * sin($latitude)) / (1 + $e * sin($latitude))) ** ($e / 2));
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $theta / $n + $lambdaOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Conformal (2SP Belgium)
     * In 2000 this modification was replaced through use of the regular Lambert Conic Conformal (2SP) method [9802]
     * with appropriately modified parameter values.
     */
    public function lambertConicConformal2SPBelgium(
        Geographic $to,
        Angle $falseOriginLatitude,
        Angle $falseOriginLongitude,
        Angle $firstStandardParallellLatitude,
        Angle $secondStandardParallellLatitude,
        Length $falseOriginEasting,
        Length $falseOriginNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseOriginEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue();
        $lambdaOrigin = $falseOriginLongitude->asRadians()->getValue();
        $phiF = $falseOriginLatitude->asRadians()->getValue();
        $phi1 = $firstStandardParallellLatitude->asRadians()->getValue();
        $phi2 = $secondStandardParallellLatitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $m1 = cos($phi1) / sqrt(1 - $e2 * sin($phi1) ** 2);
        $m2 = cos($phi2) / sqrt(1 - $e2 * sin($phi2) ** 2);
        $t1 = tan(M_PI / 4 - $phi1 / 2) / ((1 - $e * sin($phi1)) / (1 + $e * sin($phi1))) ** ($e / 2);
        $t2 = tan(M_PI / 4 - $phi2 / 2) / ((1 - $e * sin($phi2)) / (1 + $e * sin($phi2))) ** ($e / 2);
        $tF = tan(M_PI / 4 - $phiF / 2) / ((1 - $e * sin($phiF)) / (1 + $e * sin($phiF))) ** ($e / 2);
        $n = (log($m1) - log($m2)) / (log($t1) - log($t2));
        $F = $m1 / ($n * $t1 ** $n);
        $rF = $a * $F * $tF ** $n;
        if (is_nan($rF)) {
            $rF = 0;
        }
        $r = sqrt($easting ** 2 + ($rF - $northing) ** 2) * static::sign($n);
        $t = ($r / ($a * $F)) ** (1 / $n);
        if ($n >= 0) {
            $theta = atan2($easting, $rF - $northing);
        } else {
            $theta = atan2(-$easting, -($rF - $northing));
        }

        $latitude = M_PI / 2 - 2 * atan($t);
        do {
            $latitudeN = $latitude;
            $latitude = M_PI / 2 - 2 * atan($t * ((1 - $e * sin($latitude)) / (1 + $e * sin($latitude))) ** ($e / 2));
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = ($theta + (new ArcSecond(29.2985))->asRadians()->getValue()) / $n + $lambdaOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Conic Near-Conformal
     * The Lambert Near-Conformal projection is derived from the Lambert Conformal Conic projection by truncating the
     * series expansion of the projection formulae.
     */
    public function lambertConicNearConformal(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $f = $this->crs->getDatum()->getEllipsoid()->getInverseFlattening();

        $n = $f / (2 - $f);
        $rhoO = $a * (1 - $e2) / (1 - $e2 * sin($latitudeOrigin) ** 2) ** (3 / 2);
        $nuO = $a / sqrt(1 - $e2 * (sin($latitudeOrigin) ** 2));
        $A = 1 / (6 * $rhoO * $nuO);
        $APrime = $a * (1 - $n + 5 * ($n ** 2 - $n ** 3) / 4 + 81 * ($n ** 4 - $n ** 5) / 64);
        $BPrime = 3 * $a * ($n - $n ** 2 + 7 * ($n ** 3 - $n ** 4) / 8 + 55 * $n ** 5 / 64) / 2;
        $CPrime = 15 * $a * ($n ** 2 - $n ** 3 + 3 * ($n ** 4 - $n ** 5) / 4) / 16;
        $DPrime = 35 * $a * ($n ** 3 - $n ** 4 + 11 * $n ** 5 / 16) / 48;
        $EPrime = 315 * $a * ($n ** 4 - $n ** 5) / 512;
        $rO = $scaleFactorOrigin * $nuO / tan($latitudeOrigin);
        $sO = $APrime * $latitudeOrigin - $BPrime * sin(2 * $latitudeOrigin) + $CPrime * sin(4 * $latitudeOrigin) - $DPrime * sin(6 * $latitudeOrigin) + $EPrime * sin(8 * $latitudeOrigin);

        $theta = atan2($easting, $rO - $northing);
        $r = sqrt($easting ** 2 + ($rO - $northing) ** 2) * static::sign($latitudeOrigin);
        $M = $rO - $r;

        $m = $M;
        do {
            $mN = $m;
            $m = $m - ($M - $scaleFactorOrigin * $m - $scaleFactorOrigin * $A * $m ** 3) / (-$scaleFactorOrigin - 3 * $scaleFactorOrigin * $A * $m ** 2);
        } while (abs($m - $mN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $latitude = $latitudeOrigin + $m / $A;
        do {
            $latitudeN = $latitude;
            $latitude = $latitude + ($m + $sO - ($APrime * $latitude - $BPrime * sin(2 * $latitude) + $CPrime * sin(4 * $latitude) - $DPrime * sin(6 * $latitude) + $EPrime * sin(8 * $latitude))) / $APrime;
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $longitude = $longitudeOrigin + $theta / sin($latitudeOrigin);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Lambert Cylindrical Equal Area
     * This is the ellipsoidal form of the projection.
     */
    public function lambertCylindricalEqualArea(
        Geographic $to,
        Angle $firstStandardParallelLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeFirstParallel = $firstStandardParallelLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;

        $k = cos($latitudeFirstParallel) / sqrt(1 - $e2 * sin($latitudeFirstParallel) ** 2);
        $qP = (1 - $e2) * ((sin(M_PI_2) / (1 - $e2 * sin(M_PI_2) ** 2)) - (1 / (2 * $e)) * log((1 - $e * sin(M_PI_2)) / (1 + $e * sin(M_PI_2))));
        $beta = asin(2 * $northing * $k / ($a * $qP));

        $latitude = $beta + (($e2 / 3 + 31 * $e4 / 180 + 517 * $e6 / 5040) * sin(2 * $beta)) + ((23 * $e4 / 360 + 251 * $e6 / 3780) * sin(4 * $beta)) + ((761 * $e6 / 45360) * sin(6 * $beta));
        $longitude = $longitudeOrigin + $easting / ($a * $k);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Modified Azimuthal Equidistant
     * Modified form of Oblique Azimuthal Equidistant projection method developed for Polynesian islands. For the
     * distances over which these projections are used (under 800km) this modification introduces no significant error.
     */
    public function modifiedAzimuthalEquidistant(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $nuO = $a / sqrt(1 - $e2 * sin($latitudeOrigin) ** 2);
        $c = sqrt($easting ** 2 + $northing ** 2);
        $alpha = atan2($easting, $northing);
        $A = -$e2 * cos($latitudeOrigin) ** 2 * cos($alpha) ** 2 / (1 - $e2);
        $B = 3 * $e2 * (1 - $A) * sin($latitudeOrigin) * cos($latitudeOrigin) * cos($alpha) / (1 - $e2);
        $D = $c / $nuO;
        $J = $D - ($A * (1 + $A) * $D ** 3 / 6) - ($B * (1 + 3 * $A) * $D ** 4 / 24);
        $K = 1 - ($A * $J ** 2 / 2) - ($B * $J ** 3 / 6);
        $psi = asin(sin($latitudeOrigin) * cos($J) + cos($latitudeOrigin) * sin($J) * cos($alpha));

        $latitude = atan((1 - $e2 * $K * sin($latitudeOrigin) / sin($psi)) * tan($psi) / (1 - $e2));
        $longitude = $longitudeOrigin + asin(sin($alpha) * sin($J) / cos($psi));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Oblique Stereographic
     * This is not the same as the projection method of the same name in USGS Professional Paper no. 1395, "Map
     * Projections - A Working Manual" by John P. Snyder.
     */
    public function obliqueStereographic(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $rhoOrigin = $a * (1 - $e2) / (1 - $e2 * sin($latitudeOrigin) ** 2) ** (3 / 2);
        $nuOrigin = $a / sqrt(1 - $e2 * (sin($latitudeOrigin) ** 2));
        $R = sqrt($rhoOrigin * $nuOrigin);

        $n = sqrt(1 + ($e2 * cos($latitudeOrigin) ** 4 / (1 - $e2)));
        $S1 = (1 + sin($latitudeOrigin)) / (1 - sin($latitudeOrigin));
        $S2 = (1 - $e * sin($latitudeOrigin)) / (1 + $e * sin($latitudeOrigin));
        $w1 = ($S1 * ($S2 ** $e)) ** $n;
        $c = (($n + sin($latitudeOrigin)) * (1 - ($w1 - 1) / ($w1 + 1))) / (($n - sin($latitudeOrigin)) * (1 + ($w1 - 1) / ($w1 + 1)));
        $w2 = $c * $w1;
        $chiOrigin = asin(($w2 - 1) / ($w2 + 1));

        $g = 2 * $R * $scaleFactorOrigin * tan(M_PI / 4 - $chiOrigin / 2);
        $h = 4 * $R * $scaleFactorOrigin * tan($chiOrigin) + $g;
        $i = atan2($easting, ($h + $northing));
        $j = atan2($easting, ($g - $northing)) - $i;
        $chi = $chiOrigin + 2 * atan(($northing - $easting * tan($j / 2)) / (2 * $R * $scaleFactorOrigin));
        $lambda = $j + 2 * $i + $longitudeOrigin;

        $longitude = ($lambda - $longitudeOrigin) / $n + $longitudeOrigin;

        $psi = 0.5 * log((1 + sin($chi)) / ($c * (1 - sin($chi)))) / $n;

        $latitude = 2 * atan(M_E ** $psi) - M_PI / 2;
        do {
            $latitudeN = $latitude;
            $psiN = log((tan($latitudeN / 2 + M_PI / 4)) * ((1 - $e * sin($latitudeN)) / (1 + $e * sin($latitudeN))) ** ($e / 2));
            $latitude = $latitudeN - ($psiN - $psi) * cos($latitudeN) * (1 - $e2 * sin($latitudeN) ** 2) / (1 - $e2);
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Polar Stereographic (variant A)
     * Latitude of natural origin must be either 90 degrees or -90 degrees (or equivalent in alternative angle unit).
     */
    public function polarStereographicVariantA(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $rho = sqrt($easting ** 2 + $northing ** 2);
        $t = $rho * sqrt((1 + $e) ** (1 + $e) * (1 - $e) ** (1 - $e)) / (2 * $a * $scaleFactorOrigin);

        if ($latitudeOrigin < 0) {
            $chi = 2 * atan($t) - M_PI / 2;
        } else {
            $chi = M_PI / 2 - 2 * atan($t);
        }

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);

        if ($easting === 0) {

            $longitude = $longitudeOrigin;
        } elseif ($latitudeOrigin < 0) {
            $longitude = $longitudeOrigin + atan2($easting, $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue());
        } else {
            $longitude = $longitudeOrigin + atan2($easting, $falseNorthing->asMetres()->getValue() - $this->northing->asMetres()->getValue());
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Polar Stereographic (variant B).
     */
    public function polarStereographicVariantB(
        Geographic $to,
        Angle $standardParallelLatitude,
        Angle $longitudeOfOrigin,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $standardParallel = $standardParallelLatitude->asRadians()->getValue();
        $longitudeOrigin = $longitudeOfOrigin->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $rho = sqrt($easting ** 2 + $northing ** 2);
        if ($standardParallel < 0) {
            $tF = tan(M_PI / 4 + $standardParallel / 2) / (((1 + $e * sin($standardParallel)) / (1 - $e * sin($standardParallel))) ** ($e / 2));
        } else {
            $tF = tan(M_PI / 4 - $standardParallel / 2) * (((1 + $e * sin($standardParallel)) / (1 - $e * sin($standardParallel))) ** ($e / 2));
        }
        $mF = cos($standardParallel) / sqrt(1 - $e2 * sin($standardParallel) ** 2);
        $kO = $mF * sqrt((1 + $e) ** (1 + $e) * (1 - $e) ** (1 - $e)) / (2 * $tF);
        $t = $rho * sqrt((1 + $e) ** (1 + $e) * (1 - $e) ** (1 - $e)) / (2 * $a * $kO);

        if ($standardParallel < 0) {
            $chi = 2 * atan($t) - M_PI / 2;
        } else {
            $chi = M_PI / 2 - 2 * atan($t);
        }

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);

        if ($easting === 0) {

            $longitude = $longitudeOrigin;
        } elseif ($standardParallel < 0) {
            $longitude = $longitudeOrigin + atan2($easting, $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue());
        } else {
            $longitude = $longitudeOrigin + atan2($easting, $falseNorthing->asMetres()->getValue() - $this->northing->asMetres()->getValue());
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Polar Stereographic (variant C).
     */
    public function polarStereographicVariantC(
        Geographic $to,
        Angle $standardParallelLatitude,
        Angle $longitudeOfOrigin,
        Length $falseOriginEasting,
        Length $falseOriginNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseOriginEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue();
        $standardParallel = $standardParallelLatitude->asRadians()->getValue();
        $longitudeOrigin = $longitudeOfOrigin->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        if ($standardParallel < 0) {
            $tF = tan(M_PI / 4 + $standardParallel / 2) / (((1 + $e * sin($standardParallel)) / (1 - $e * sin($standardParallel))) ** ($e / 2));
        } else {
            $tF = tan(M_PI / 4 - $standardParallel / 2) * (((1 + $e * sin($standardParallel)) / (1 - $e * sin($standardParallel))) ** ($e / 2));
        }
        $mF = cos($standardParallel) / sqrt(1 - $e2 * sin($standardParallel) ** 2);
        $rhoF = $a * $mF;
        if ($standardParallel < 0) {
            $rho = sqrt($easting ** 2 + ($northing + $rhoF) ** 2);
            $t = $rho * $tF / $rhoF;
            $chi = 2 * atan($t) - M_PI / 2;
        } else {
            $rho = sqrt($easting ** 2 + ($northing - $rhoF) ** 2);
            $t = $rho * $tF / $rhoF;
            $chi = M_PI / 2 - 2 * atan($t);
        }

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);

        if ($easting === 0) {

            $longitude = $longitudeOrigin;
        } elseif ($standardParallel < 0) {
            $longitude = $longitudeOrigin + atan2($easting, $this->northing->asMetres()->getValue() - $falseOriginNorthing->asMetres()->getValue() + $rhoF);
        } else {
            $longitude = $longitudeOrigin + atan2($easting, $falseOriginNorthing->asMetres()->getValue() - $this->northing->asMetres()->getValue() + $rhoF);
        }

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Popular Visualisation Pseudo Mercator
     * Applies spherical formulas to the ellipsoid. As such does not have the properties of a true Mercator projection.
     */
    public function popularVisualisationPseudoMercator(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();

        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();

        $D = -$northing / $a;
        $latitude = M_PI / 2 - 2 * atan(M_E ** $D);
        $longitude = $easting / $a + $longitudeOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Similarity transformation
     * Defined for two-dimensional coordinate systems.
     */
    public function similarityTransformation(
        Projected $to,
        Length $targetOrdinate1,
        Length $targetOrdinate2,
        Scale $scaleFactorOfSourceAxes,
        Angle $rotationAngleOfSourceAxes
    ): self {
        $xs = $this->easting->asMetres()->getValue();
        $ys = $this->northing->asMetres()->getValue();
        $xo = $targetOrdinate1->asMetres()->getValue();
        $yo = $targetOrdinate2->asMetres()->getValue();
        $M = $scaleFactorOfSourceAxes->asUnity()->getValue();
        $theta = $rotationAngleOfSourceAxes->asRadians()->getValue();

        $easting = $xo + $xs * $M * cos($theta) + $ys * $M * sin($theta);
        $northing = $yo - $xs * $M * sin($theta) + $ys * $M * cos($theta);

        return self::create(new Metre($easting), new Metre($northing), new Metre(-$easting), new Metre(-$northing), $to, $this->epoch);
    }

    /**
     * Mercator (variant A)
     * Note that in these formulas the parameter latitude of natural origin (latO) is not used. However for this
     * Mercator (variant A) method the EPSG dataset includes this parameter, which must have a value of zero, for
     * completeness in CRS labelling.
     */
    public function mercatorVariantA(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();

        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();

        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $scaleFactorOrigin = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();

        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $t = M_E ** (($falseNorthing->asMetres()->getValue() - $this->northing->asMetres()->getValue()) / ($a * $scaleFactorOrigin));
        $chi = M_PI / 2 - 2 * atan($t);

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);
        $longitude = $easting / ($a * $scaleFactorOrigin) + $longitudeOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Mercator (variant B)
     * Used for most nautical charts.
     */
    public function mercatorVariantB(
        Geographic $to,
        Angle $firstStandardParallelLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();

        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $firstStandardParallel = $firstStandardParallelLatitude->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();

        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $scaleFactorOrigin = cos($firstStandardParallel) / sqrt(1 - $e2 * sin($firstStandardParallel) ** 2);

        $t = M_E ** (($falseNorthing->asMetres()->getValue() - $this->northing->asMetres()->getValue()) / ($a * $scaleFactorOrigin));
        $chi = M_PI / 2 - 2 * atan($t);

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);
        $longitude = $easting / ($a * $scaleFactorOrigin) + $longitudeOrigin;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Hotine Oblique Mercator (variant A).
     */
    public function obliqueMercatorHotineVariantA(
        Geographic $to,
        Angle $latitudeOfProjectionCentre,
        Angle $longitudeOfProjectionCentre,
        Angle $azimuthOfInitialLine,
        Angle $angleFromRectifiedToSkewGrid,
        Scale $scaleFactorOnInitialLine,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latC = $latitudeOfProjectionCentre->asRadians()->getValue();
        $lonC = $longitudeOfProjectionCentre->asRadians()->getValue();
        $alphaC = $azimuthOfInitialLine->asRadians()->getValue();
        $kC = $scaleFactorOnInitialLine->asUnity()->getValue();
        $gammaC = $angleFromRectifiedToSkewGrid->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $B = sqrt(1 + ($e2 * cos($latC) ** 4 / (1 - $e2)));
        $A = $a * $B * $kC * (1 - $e2) ** 0.5 / (1 - $e2 * sin($latC) ** 2);
        $tO = tan(M_PI / 4 - $latC / 2) / ((1 - $e * sin($latC)) / (1 + $e * sin($latC))) ** ($e / 2);
        $D = $B * (1 - $e2) ** 0.5 / (cos($latC) * sqrt(1 - $e2 * sin($latC) ** 2));
        $DD = max(1, $D ** 2);
        $F = $D + sqrt($DD - 1) * static::sign($alphaC);
        $H = $F * ($tO) ** $B;
        $G = ($F - 1 / $F) / 2;
        $gammaO = asin(sin($alphaC) / $D);
        $lonO = $lonC - (asin($G * tan($gammaO))) / $B;

        $v = $easting * cos($gammaC) - $northing * sin($gammaC);
        $u = $northing * cos($gammaC) + $easting * sin($gammaC);

        $Q = M_E ** -($B * $v / $A);
        $S = ($Q - 1 / $Q) / 2;
        $T = ($Q + 1 / $Q) / 2;
        $V = sin($B * $u / $A);
        $U = ($V * cos($gammaC) + $S * sin($gammaC)) / $T;
        $t = ($H / sqrt((1 + $U) / (1 - $U))) ** (1 / $B);

        $chi = M_PI / 2 - 2 * atan($t);

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);
        $longitude = $lonO - atan2(($S * cos($gammaO) - $V * sin($gammaO)), cos($B * $u / $A)) / $B;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Hotine Oblique Mercator (variant A).
     */
    public function obliqueMercatorHotineVariantB(
        Geographic $to,
        Angle $latitudeOfProjectionCentre,
        Angle $longitudeOfProjectionCentre,
        Angle $azimuthOfInitialLine,
        Angle $angleFromRectifiedToSkewGrid,
        Scale $scaleFactorOnInitialLine,
        Length $eastingAtProjectionCentre,
        Length $northingAtProjectionCentre
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $eastingAtProjectionCentre->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $northingAtProjectionCentre->asMetres()->getValue();
        $latC = $latitudeOfProjectionCentre->asRadians()->getValue();
        $lonC = $longitudeOfProjectionCentre->asRadians()->getValue();
        $alphaC = $azimuthOfInitialLine->asRadians()->getValue();
        $kC = $scaleFactorOnInitialLine->asUnity()->getValue();
        $gammaC = $angleFromRectifiedToSkewGrid->asRadians()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();
        $e4 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 4;
        $e6 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 6;
        $e8 = $this->crs->getDatum()->getEllipsoid()->getEccentricity() ** 8;

        $B = sqrt(1 + ($e2 * cos($latC) ** 4 / (1 - $e2)));
        $A = $a * $B * $kC * (1 - $e2) ** 0.5 / (1 - $e2 * sin($latC) ** 2);
        $tO = tan(M_PI / 4 - $latC / 2) / ((1 - $e * sin($latC)) / (1 + $e * sin($latC))) ** ($e / 2);
        $D = $B * (1 - $e2) ** 0.5 / (cos($latC) * sqrt(1 - $e2 * sin($latC) ** 2));
        $DD = max(1, $D ** 2);
        $F = $D + sqrt($DD - 1) * static::sign($alphaC);
        $H = $F * ($tO) ** $B;
        $G = ($F - 1 / $F) / 2;
        $gammaO = asin(sin($alphaC) / $D);
        $lonO = $lonC - (asin($G * tan($gammaO))) / $B;
        $vC = 0;

        if ($alphaC === M_PI / 2) {
            $uC = $A * ($lonC - $lonO);
        } else {
            $uC = ($A / $B) * atan2(sqrt($DD - 1), cos($alphaC)) * static::sign($latC);
        }

        $v = $easting * cos($gammaC) - $northing * sin($gammaC);
        $u = $northing * cos($gammaC) + $easting * sin($gammaC) + (abs($uC) * static::sign($latC));

        $Q = M_E ** -($B * $v / $A);
        $S = ($Q - 1 / $Q) / 2;
        $T = ($Q + 1 / $Q) / 2;
        $V = sin($B * $u / $A);
        $U = ($V * cos($gammaC) + $S * sin($gammaC)) / $T;
        $t = ($H / sqrt((1 + $U) / (1 - $U))) ** (1 / $B);

        $chi = M_PI / 2 - 2 * atan($t);

        $latitude = $chi + ($e2 / 2 + 5 * $e4 / 24 + $e6 / 12 + 13 * $e8 / 360) * sin(2 * $chi) + (7 * $e4 / 48 + 29 * $e6 / 240 + 811 * $e8 / 11520) * sin(4 * $chi) + (7 * $e6 / 120 + 81 * $e8 / 1120) * sin(6 * $chi) + (4279 * $e8 / 161280) * sin(8 * $chi);
        $longitude = $lonO - atan2(($S * cos($gammaO) - $V * sin($gammaO)), cos($B * $u / $A)) / $B;

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Laborde Oblique Mercator.
     */
    public function obliqueMercatorLaborde(
        Geographic $to,
        Angle $latitudeOfProjectionCentre,
        Angle $longitudeOfProjectionCentre,
        Angle $azimuthOfInitialLine,
        Scale $scaleFactorOnInitialLine,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latC = $latitudeOfProjectionCentre->asRadians()->getValue();
        $lonC = $longitudeOfProjectionCentre->asRadians()->getValue();
        $alphaC = $azimuthOfInitialLine->asRadians()->getValue();
        $kC = $scaleFactorOnInitialLine->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $e2 = $this->crs->getDatum()->getEllipsoid()->getEccentricitySquared();

        $B = sqrt(1 + ($e2 * cos($latC) ** 4 / (1 - $e2)));
        $latS = asin(sin($latC) / $B);
        $R = $a * $kC * (sqrt(1 - $e2) / (1 - $e2 * sin($latC) ** 2));
        $C = log(tan(M_PI / 4 + $latS / 2)) - $B * log(tan(M_PI / 4 + $latC / 2) * ((1 - $e * sin($latC)) / (1 + $e * sin($latC))) ** ($e / 2));

        $G = (new ComplexNumber(1 - cos(2 * $alphaC), sin(2 * $alphaC)))->divide(new ComplexNumber(12, 0));

        $H0 = new ComplexNumber($northing / $R, $easting / $R);
        $H = $H0->divide($H0->pow(3)->multiply($G)->add($H0));
        do {
            $HN = $H;
            $H = ($HN->pow(3)->multiply($G)->multiply(new ComplexNumber(2, 0))->add($H0))->divide($HN->pow(2)->multiply($G)->multiply(new ComplexNumber(3, 0))->add(new ComplexNumber(1, 0)));
        } while (abs($H0->subtract($H)->subtract($H->pow(3)->multiply($G))->getReal()) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $LPrime = -1 * $H->getReal();
        $PPrime = 2 * atan(M_E ** $H->getImaginary()) - M_PI / 2;
        $U = cos($PPrime) * cos($LPrime) * cos($latS) + cos($PPrime) * sin($LPrime) * sin($latS);
        $V = sin($PPrime);
        $W = cos($PPrime) * cos($LPrime) * sin($latS) - cos($PPrime) * sin($LPrime) * cos($latS);

        $d = sqrt($U ** 2 + $V ** 2);
        if ($d === 0) {
            $L = 0;
            $P = static::sign($W) * M_PI / 2;
        } else {
            $L = 2 * atan($V / ($U + $d));
            $P = atan($W / $d);
        }

        $longitude = $lonC + ($L / $B);

        $q = (log(tan(M_PI / 4 + $P / 2)) - $C) / $B;

        $latitude = 2 * atan(M_E ** $q) - M_PI / 2;
        do {
            $latitudeN = $latitude;
            $latitude = 2 * atan(((1 + $e * sin($latitude)) / (1 - $e * sin($latitude))) ** ($e / 2) * M_E ** $q) - M_PI / 2;
        } while (abs($latitude - $latitudeN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Transverse Mercator.
     */
    public function transverseMercator(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $easting = $this->easting->asMetres()->getValue() - $falseEasting->asMetres()->getValue();
        $northing = $this->northing->asMetres()->getValue() - $falseNorthing->asMetres()->getValue();
        $latitudeOrigin = $naturalOriginLatitude->asRadians()->getValue();
        $longitudeOrigin = $naturalOriginLongitude->asRadians()->getValue();
        $kO = $naturalOriginScaleFactor->asUnity()->getValue();
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();
        $e = $this->crs->getDatum()->getEllipsoid()->getEccentricity();
        $f = $this->crs->getDatum()->getEllipsoid()->getInverseFlattening();

        $n = $f / (2 - $f);
        $B = ($a / (1 + $n)) * (1 + $n ** 2 / 4 + $n ** 4 / 64);

        $h1 = $n / 2 - (2 / 3) * $n ** 2 + (37 / 96) * $n ** 3 - (1 / 360) * $n ** 4;
        $h2 = (1 / 48) * $n ** 2 + (1 / 15) * $n ** 3 - (437 / 1440) * $n ** 4;
        $h3 = (17 / 480) * $n ** 3 - (37 / 840) * $n ** 4;
        $h4 = (4397 / 161280) * $n ** 4;

        if ($latitudeOrigin === 0) {

            $mO = 0;
        } elseif ($latitudeOrigin === M_PI / 2) {
            $mO = $B * M_PI / 2;
        } elseif ($latitudeOrigin === -M_PI / 2) {
            $mO = $B * -M_PI / 2;
        } else {
            $qO = asinh(tan($latitudeOrigin)) - ($e * atanh($e * sin($latitudeOrigin)));
            $betaO = atan(sinh($qO));
            $xiO0 = asin(sin($betaO));
            $xiO1 = $h1 * sin(2 * $xiO0);
            $xiO2 = $h2 * sin(4 * $xiO0);
            $xiO3 = $h3 * sin(6 * $xiO0);
            $xiO4 = $h4 * sin(8 * $xiO0);
            $xiO = $xiO0 + $xiO1 + $xiO2 + $xiO3 + $xiO4;
            $mO = $B * $xiO;
        }

        $eta = $easting / ($B * $kO);
        $xi = ($northing + $kO * $mO) / ($B * $kO);
        $xi1 = $h1 * sin(2 * $xi) * cosh(2 * $eta);
        $eta1 = $h1 * cos(2 * $xi) * sinh(2 * $eta);
        $xi2 = $h2 * sin(4 * $xi) * cosh(4 * $eta);
        $eta2 = $h2 * cos(4 * $xi) * sinh(4 * $eta);
        $xi3 = $h3 * sin(6 * $xi) * cosh(6 * $eta);
        $eta3 = $h3 * cos(6 * $xi) * sinh(6 * $eta);
        $xi4 = $h4 * sin(8 * $xi) * cosh(8 * $eta);
        $eta4 = $h4 * cos(8 * $xi) * sinh(8 * $eta);
        $xi0 = $xi - ($xi1 + $xi2 + $xi3 + $xi4);
        $eta0 = $eta - ($eta1 + $eta2 + $eta3 + $eta4);

        $beta = asin(sin($xi0) / cosh($eta0));

        $QPrime = asinh(tan($beta));
        $Q = asinh(tan($beta));
        do {
            $QN = $Q;
            $Q = $QPrime + ($e * atanh($e * tanh($Q)));
        } while (abs($Q - $QN) >= self::NEWTON_RAPHSON_CONVERGENCE);

        $latitude = atan(sinh($Q));
        $longitude = $longitudeOrigin + asin(tanh($eta0) / cos($beta));

        return GeographicPoint::create(new Radian($latitude), new Radian($longitude), null, $to, $this->epoch);
    }

    /**
     * Transverse Mercator Zoned Grid System
     * If locations fall outwith the fixed zones the general Transverse Mercator method (code 9807) must be used for
     * each zone.
     */
    public function transverseMercatorZonedGrid(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $initialLongitude,
        Angle $zoneWidth,
        Scale $naturalOriginScaleFactor,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $Z = substr((string) $this->easting->asMetres()->getValue(), 0, 2);
        $falseEasting = $falseEasting->add(new Metre($Z * 1000000));

        $W = $zoneWidth->asDegrees()->getValue();
        $longitudeOrigin = $initialLongitude->add(new Degree($Z * $W - $W / 2));

        return $this->transverseMercator($to, $naturalOriginLatitude, $longitudeOrigin, $naturalOriginScaleFactor, $falseEasting, $falseNorthing);
    }

    /**
     * General polynomial.
     * @param Coefficient[] $powerCoefficients
     */
    public function generalPolynomial(
        Projected $to,
        Angle $ordinate1OfEvaluationPointInSourceCRS,
        Angle $ordinate2OfEvaluationPointInSourceCRS,
        Angle $ordinate1OfEvaluationPointInTargetCRS,
        Angle $ordinate2OfEvaluationPointInTargetCRS,
        Coefficient $scalingFactorForSourceCRSCoordDifferences,
        Coefficient $scalingFactorForTargetCRSCoordDifferences,
        Coefficient $A0,
        Coefficient $B0,
        array $powerCoefficients
    ): self {
        $xs = $this->easting->getValue();
        $ys = $this->northing->getValue();

        $t = $this->generalPolynomialUnitless(
            $xs,
            $ys,
            $ordinate1OfEvaluationPointInSourceCRS,
            $ordinate2OfEvaluationPointInSourceCRS,
            $ordinate1OfEvaluationPointInTargetCRS,
            $ordinate2OfEvaluationPointInTargetCRS,
            $scalingFactorForSourceCRSCoordDifferences,
            $scalingFactorForTargetCRSCoordDifferences,
            $A0,
            $B0,
            $powerCoefficients
        );

        $xtUnit = $to->getCoordinateSystem()->getAxes()[0]->getUnitOfMeasureId();
        $ytUnit = $to->getCoordinateSystem()->getAxes()[1]->getUnitOfMeasureId();

        return static::createFromEastingNorthing(
            Length::makeUnit($t['xt'], $xtUnit),
            Length::makeUnit($t['yt'], $ytUnit),
            $to,
            $this->epoch
        );
    }

    /**
     * New Zealand Map Grid.
     */
    public function newZealandMapGrid(
        Geographic $to,
        Angle $naturalOriginLatitude,
        Angle $naturalOriginLongitude,
        Length $falseEasting,
        Length $falseNorthing
    ): GeographicPoint {
        $a = $this->crs->getDatum()->getEllipsoid()->getSemiMajorAxis()->asMetres()->getValue();

        $z = new ComplexNumber(
            $this->northing->subtract($falseNorthing)->divide($a)->asMetres()->getValue(),
            $this->easting->subtract($falseEasting)->divide($a)->asMetres()->getValue(),
        );

        $B1 = new ComplexNumber(0.7557853228, 0.0);
        $B2 = new ComplexNumber(0.249204646, 0.003371507);
        $B3 = new ComplexNumber(-0.001541739, 0.041058560);
        $B4 = new ComplexNumber(-0.10162907, 0.01727609);
        $B5 = new ComplexNumber(-0.26623489, -0.36249218);
        $B6 = new ComplexNumber(-0.6870983, -1.1651967);
        $b1 = new ComplexNumber(1.3231270439, 0.0);
        $b2 = new ComplexNumber(-0.577245789, -0.007809598);
        $b3 = new ComplexNumber(0.508307513, -0.112208952);
        $b4 = new ComplexNumber(-0.15094762, 0.18200602);
        $b5 = new ComplexNumber(1.01418179, 1.64497696);
        $b6 = new ComplexNumber(1.9660549, 2.5127645);

        $zeta = new ComplexNumber(0, 0);
        $zeta = $zeta->add($b1->multiply($z->pow(1)));
        $zeta = $zeta->add($b2->multiply($z->pow(2)));
        $zeta = $zeta->add($b3->multiply($z->pow(3)));
        $zeta = $zeta->add($b4->multiply($z->pow(4)));
        $zeta = $zeta->add($b5->multiply($z->pow(5)));
        $zeta = $zeta->add($b6->multiply($z->pow(6)));

        for ($iterations = 0; $iterations < 2; ++$iterations) {
            $numerator = $z;
            $numerator = $numerator->add($B2->multiply($zeta->pow(2))->multiply(new ComplexNumber(1, 0)));
            $numerator = $numerator->add($B3->multiply($zeta->pow(3))->multiply(new ComplexNumber(2, 0)));
            $numerator = $numerator->add($B4->multiply($zeta->pow(4))->multiply(new ComplexNumber(3, 0)));
            $numerator = $numerator->add($B5->multiply($zeta->pow(5))->multiply(new ComplexNumber(4, 0)));
            $numerator = $numerator->add($B6->multiply($zeta->pow(6))->multiply(new ComplexNumber(5, 0)));

            $denominator = $B1;
            $denominator = $denominator->add($B2->multiply($zeta->pow(1))->multiply(new ComplexNumber(2, 0)));
            $denominator = $denominator->add($B3->multiply($zeta->pow(2))->multiply(new ComplexNumber(3, 0)));
            $denominator = $denominator->add($B4->multiply($zeta->pow(3))->multiply(new ComplexNumber(4, 0)));
            $denominator = $denominator->add($B5->multiply($zeta->pow(4))->multiply(new ComplexNumber(5, 0)));
            $denominator = $denominator->add($B6->multiply($zeta->pow(5))->multiply(new ComplexNumber(6, 0)));

            $zeta = $numerator->divide($denominator);
        }

        $deltaPsi = $zeta->getReal();
        $deltaLatitudeToOrigin = 0;
        $deltaLatitudeToOrigin += 1.5627014243 * $deltaPsi ** 1;
        $deltaLatitudeToOrigin += 0.5185406398 * $deltaPsi ** 2;
        $deltaLatitudeToOrigin += -0.03333098 * $deltaPsi ** 3;
        $deltaLatitudeToOrigin += -0.1052906 * $deltaPsi ** 4;
        $deltaLatitudeToOrigin += -0.0368594 * $deltaPsi ** 5;
        $deltaLatitudeToOrigin += 0.007317 * $deltaPsi ** 6;
        $deltaLatitudeToOrigin += 0.01220 * $deltaPsi ** 7;
        $deltaLatitudeToOrigin += 0.00394 * $deltaPsi ** 8;
        $deltaLatitudeToOrigin += -0.0013 * $deltaPsi ** 9;

        $latitude = $naturalOriginLatitude->add(new ArcSecond($deltaLatitudeToOrigin / 0.00001));
        $longitude = $naturalOriginLongitude->add(new Radian($zeta->getImaginary()));

        return GeographicPoint::create($latitude, $longitude, null, $to, $this->epoch);
    }

    /**
     * Complex polynomial.
     * Coordinate pairs treated as complex numbers.  This exploits the correlation between the polynomial coefficients
     * and leads to a smaller number of coefficients than the general polynomials.
     */
    public function complexPolynomial(
        Projected $to,
        Length $ordinate1OfEvaluationPointInSourceCRS,
        Length $ordinate2OfEvaluationPointInSourceCRS,
        Length $ordinate1OfEvaluationPointInTargetCRS,
        Length $ordinate2OfEvaluationPointInTargetCRS,
        Coefficient $scalingFactorForSourceCRSCoordDifferences,
        Coefficient $scalingFactorForTargetCRSCoordDifferences,
        Coefficient $A1,
        Coefficient $A2,
        Coefficient $A3,
        Coefficient $A4,
        Coefficient $A5,
        Coefficient $A6,
        ?Coefficient $A7 = null,
        ?Coefficient $A8 = null
    ): self {
        $xs = $this->easting->getValue();
        $ys = $this->northing->getValue();
        $xso = $ordinate1OfEvaluationPointInSourceCRS->getValue();
        $yso = $ordinate2OfEvaluationPointInSourceCRS->getValue();
        $xto = $ordinate1OfEvaluationPointInTargetCRS->getValue();
        $yto = $ordinate2OfEvaluationPointInTargetCRS->getValue();

        $U = $scalingFactorForSourceCRSCoordDifferences->asUnity()->getValue() * ($xs - $xso);
        $V = $scalingFactorForSourceCRSCoordDifferences->asUnity()->getValue() * ($ys - $yso);

        $mTdXdY = new ComplexNumber(0,0);
        $mTdXdY = $mTdXdY->add((new ComplexNumber($A1->getValue(), $A2->getValue()))->multiply(new ComplexNumber($U, $V))->pow(1));
        $mTdXdY = $mTdXdY->add((new ComplexNumber($A3->getValue(), $A4->getValue()))->multiply((new ComplexNumber($U, $V))->pow(2)));
        $mTdXdY = $mTdXdY->add((new ComplexNumber($A5->getValue(), $A6->getValue()))->multiply((new ComplexNumber($U, $V))->pow(3)));
        $mTdXdY = $mTdXdY->add((new ComplexNumber($A7 ? $A7->getValue() : 0, $A8 ? $A8->getValue() : 0))->multiply((new ComplexNumber($U, $V))->pow(4)));

        $xt = $xs - $xso + $xto + $mTdXdY->getReal() / $scalingFactorForTargetCRSCoordDifferences->asUnity()->getValue();
        $yt = $ys - $yso + $yto + $mTdXdY->getImaginary() / $scalingFactorForTargetCRSCoordDifferences->asUnity()->getValue();

        $xtUnit = $to->getCoordinateSystem()->getAxes()[0]->getUnitOfMeasureId();
        $ytUnit = $to->getCoordinateSystem()->getAxes()[1]->getUnitOfMeasureId();

        return static::createFromEastingNorthing(
            Length::makeUnit($xt, $xtUnit),
            Length::makeUnit($yt, $ytUnit),
            $to,
            $this->epoch
        );
    }
}

dvdoug / PHPCoord

Push — 4.x ( e9b635...bc20e1 )

ProjectedPoint::obliqueMercatorLaborde() A

Complexity

Size

Duplication

Code Coverage

Importance

How to fix Long Method

Long Method

Duplication Side-by-Side

Filter issues like
