Completed
Push — analysis-q52142 ( 5a9859 )
by Doug
65:31 queued 30:29
created

OSRef::toGridReference()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 22
Code Lines 15

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
dl 0
loc 22
rs 9.2
c 0
b 0
f 0
cc 1
eloc 15
nc 1
nop 1
1
<?php
2
/**
3
 * PHPCoord.
4
 *
5
 * @author Jonathan Stott
6
 * @author Doug Wright
7
 */
8
9
namespace PHPCoord;
10
11
/**
12
 * Ordnance Survey grid reference
13
 * References are accurate to 1m.
14
 *
15
 * @author Jonathan Stott
16
 * @author Doug Wright
17
 */
18
class OSRef extends TransverseMercator
19
{
20
    const GRID_LETTERS = 'VWXYZQRSTULMNOPFGHJKABCDE';
21
22
    public function getReferenceEllipsoid()
23
    {
24
        return RefEll::airy1830();
25
    }
26
27
    public function getScaleFactor()
28
    {
29
        return 0.9996012717;
30
    }
31
32
    public function getOriginNorthing()
33
    {
34
        return -100000;
35
    }
36
37
    public function getOriginEasting()
38
    {
39
        return 400000;
40
    }
41
42
    public function getOriginLatitude()
43
    {
44
        return 49;
45
    }
46
47
    public function getOriginLongitude()
48
    {
49
        return -2;
50
    }
51
52
    /**
53
     * Create a new object representing a OSGB reference.
54
     *
55
     * @param int $x
56
     * @param int $y
57
     * @param int $z
58
     */
59
    public function __construct($x, $y, $z = 0)
60
    {
61
        parent::__construct($x, $y, $z, RefEll::airy1830());
62
    }
63
64
    /**
65
     * Take a string formatted as a six-figure OS grid reference (e.g.
66
     * "TG514131") and return a reference to an OSRef object that represents
67
     * that grid reference.
68
     *
69
     * @param string $ref
70
     *
71
     * @return OSRef
72
     */
73
    public static function fromSixFigureReference($ref)
74
    {
75
76
        //first (major) letter is the 500km grid sq, origin at -1000000, -500000
77
        $majorEasting = strpos(self::GRID_LETTERS, $ref[0]) % 5 * 500000 - 1000000;
78
        $majorNorthing = (floor(strpos(self::GRID_LETTERS, $ref[0]) / 5)) * 500000 - 500000;
79
80
        //second (minor) letter is 100km grid sq, origin at 0,0 of this square
81
        $minorEasting = strpos(self::GRID_LETTERS, $ref[1]) % 5 * 100000;
82
        $minorNorthing = (floor(strpos(self::GRID_LETTERS, $ref[1]) / 5)) * 100000;
83
84
        $easting = $majorEasting + $minorEasting + (substr($ref, 2, 3) * 100);
85
        $northing = $majorNorthing + $minorNorthing + (substr($ref, 5, 3) * 100);
86
87
        return new self($easting, $northing);
88
    }
89
90
    /**
91
     * Convert this grid reference into a grid reference string of a
92
     * given length (2, 4, 6, 8 or 10) including the two-character
93
     * designation for the 100km square. e.g. TG514131.
94
     *
95
     * @return string
96
     */
97
    private function toGridReference($length)
98
    {
99
        $halfLength = $length / 2;
100
101
        $easting = str_pad($this->x, 6, 0, STR_PAD_LEFT);
102
        $northing = str_pad($this->y, 6, 0, STR_PAD_LEFT);
103
104
        $adjustedX = $this->x + 1000000;
105
        $adjustedY = $this->y + 500000;
106
        $majorSquaresEast = floor($adjustedX / 500000);
107
        $majorSquaresNorth = floor($adjustedY / 500000);
108
        $majorLetterIndex = (int) (5 * $majorSquaresNorth + $majorSquaresEast);
109
        $majorLetter = substr(self::GRID_LETTERS, $majorLetterIndex, 1);
110
111
        //second (minor) letter is 100km grid sq, origin at 0,0 of this square
112
        $minorSquaresEast = $easting[0] % 5;
113
        $minorSquaresNorth = $northing[0] % 5;
114
        $minorLetterIndex = (int) (5 * $minorSquaresNorth + $minorSquaresEast);
115
        $minorLetter = substr(self::GRID_LETTERS, $minorLetterIndex, 1);
116
117
        return $majorLetter.$minorLetter.substr($easting, 1, $halfLength).substr($northing, 1, $halfLength);
118
    }
119
120
    /**
121
     * Convert this grid reference into a string using a standard two-figure
122
     * grid reference including the two-character designation for the 100km
123
     * square. e.g. TG51 (10km square).
124
     *
125
     * @return string
126
     */
127
    public function toTwoFigureReference()
128
    {
129
        return $this->toGridReference(2);
130
    }
131
132
    /**
133
     * Convert this grid reference into a string using a standard four-figure
134
     * grid reference including the two-character designation for the 100km
135
     * square. e.g. TG5113 (1km square).
136
     *
137
     * @return string
138
     */
139
    public function toFourFigureReference()
140
    {
141
        return $this->toGridReference(4);
142
    }
143
144
    /**
145
     * Convert this grid reference into a string using a standard six-figure
146
     * grid reference including the two-character designation for the 100km
147
     * square. e.g. TG514131 (100m square).
148
     *
149
     * @return string
150
     */
151
    public function toSixFigureReference()
152
    {
153
        return $this->toGridReference(6);
154
    }
155
156
    /**
157
     * Convert this grid reference into a string using a standard eight-figure
158
     * grid reference including the two-character designation for the 100km
159
     * square. e.g. TG51431312 (10m square).
160
     *
161
     * @return string
162
     */
163
    public function toEightFigureReference()
164
    {
165
        return $this->toGridReference(8);
166
    }
167
168
    /**
169
     * Convert this grid reference into a string using a standard ten-figure
170
     * grid reference including the two-character designation for the 100km
171
     * square. e.g. TG5143113121 (1m square).
172
     *
173
     * @return string
174
     */
175
    public function toTenFigureReference()
176
    {
177
        return $this->toGridReference(10);
178
    }
179
180
    /**
181
     * Convert this grid reference into a latitude and longitude.
182
     *
183
     * @return LatLng
184
     */
185 View Code Duplication
    public function toLatLng()
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
186
    {
187
        $N = $this->y;
188
        $E = $this->x;
189
        $N0 = $this->getOriginNorthing();
190
        $E0 = $this->getOriginEasting();
191
        $phi0 = $this->getOriginLatitude();
192
        $lambda0 = $this->getOriginLongitude();
193
194
        return $this->convertToLatitudeLongitude($N, $E, $N0, $E0, $phi0, $lambda0);
195
    }
196
197
    /**
198
     * String version of coordinate.
199
     *
200
     * @return string
201
     */
202
    public function __toString()
203
    {
204
        return "({$this->x}, {$this->y})";
205
    }
206
}
207