newpole

Origin vector to place specific point at pole

Syntax

```origin = newpole(polelat,polelon) origin = newpole(polelat,polelon,units) ```

Description

`origin = newpole(polelat,polelon)` provides the `origin` vector for a transformed coordinate system based upon moving the point (`polelat`, `polelon`) to become the north pole singularity in the new system. The origin is a three-element vector of the form ```[latitude longitude orientation]```, where the latitude and longitude are the coordinates the new center (`origin`) had in the untransformed system, and the orientation is the azimuth of the true North Pole from the new origin point. For the `newpole` calculation, this orientation is constrained to be always 0º.

`origin = newpole(polelat,polelon,units)` specifies the units of the inputs and output, where `units` is any valid angle unit. The default is `'degrees'`.

When developing transverse or oblique projections, you need transformed coordinate systems. One way to define these systems is to establish the point in the original (untransformed) system that will become the new (transformed) north pole.

Examples

Take a point and make it the new North Pole:

```origin = newpole(60,180) origin = 30.0000 0 0```

This makes sense: as a point 30º beyond the true North Pole on the original origin's meridian is pulled up to become the pole, the point originally 30º above the origin is pulled down into the origin spot.