Skip to main content

Simple parser for latitude-longitude strings

Project description

https://github.com/NOAA-ORR-ERD/lat_lon_parser/workflows/CI/badge.svg https://img.shields.io/pypi/v/lat-lon-parser.svg https://img.shields.io/pypi/pyversions/lat-lon-parser.svg https://img.shields.io/github/license/NOAA-ORR-ERD/lat_lon_parser

lat_lon_parser

Code for parsing lat-long coordinates in “various” formats, and for converting between lat-long formats (e.g. decimal degrees to degrees-minutes-seconds)

Note: perhaps it would be better to integrate this with a more full featured lib like:

https://pypi.python.org/pypi/LatLon23

But that one does not seem to support parsing unknown formats at this point – and it’s GPL, and perhaps a little more complex and structured than it needs to be.

Parsing Latitude and Longitude strings

Usage:

from lat_lon_parser import parse

In [12]: from lat_lon_parser import parse

In [13]: parse("45° 12.6' W")
Out[13]: -45.21

Formats supported:

Decimal degrees (easy):

23.43
-45.21

Decimal Degrees with quadrant:

23.43 N
45.21 W

Or with spelled out:

23.43 North
45.21 West

(note that all of the cardinal directions are not case-sensitive)

Degrees, decimal minutes: (now it starts getting tricky!):

23° 25.800'
-45° 12.600'

or:

23 25.800'
-45 12.600'

or:

23° 25.8' N
45° 12.6' West

Degrees, Minutes, Seconds: (really fun!!!):

 23° 25' 48.0"
-45° 12' 36.0"

or:

 23d 25' 48.0"
-45d 12' 36.0"

or:

23° 25' 48.0" North
45° 12' 36.0" S

or – lots of other combinations!

For a more complete list, see the tests

How it works:

This uses a pretty “stupid” algorithm – it assumes that all formats will be something like:

[-][space] degrees [separator] minutes [separator] seconds [separator] [N[orth]|S[outh|E[ast]|W[est]]

But that actually is pretty darn robust!

If you have other formats you want to be able to parse, please contribute tests! – And ideally a patch if the current code doesn’t work.

Conversion to Latitude Longitude Formats

Also included is code to convert to other formats used for latitude and longitude:

  • degrees

  • degrees minutes

  • degrees minutes seconds

Converting to numbers:

Functions for returning tuples of numbers:

>>> to_dec_deg(23, 12, 3)
23.200833333333332
>>> to_deg_min(34.1234)
(34.0, 7.404)
>>> to_deg_min_sec(34.1234)
(34.0, 7, 24.24)

Converting to strings:

Functions for converting to various string formats:

>>> to_str_dec_deg(23, 12, 3)
'23.200833°'
>>> to_str_deg_min(2.345)
"2° 20.700'"
>>> to_str_deg_min_sec(-23.1234)
'-23° 7\' 24.24"'

>>> to_str(23.45)
'23.450000°'
>>> to_str(23, 45)
"23° 45.000'"
>>> to_str(23, 45, 6.7)
'23° 45\' 6.70"'

Usage with Pandas

Question from a user:

How to apply this lat_lon_parser on pandas dataframe specific column?

Turns out it’s straightforward – just pass the parse function to apply:

In [20]: df = pandas.DataFrame({'coords':["12d13'N","32 5 14", "30.123W"]})

In [21]: df
Out[21]:
    coords
0  12d13'N
1  32 5 14
2  30.123W

In [22]: df['coords'] = df['coords'].apply(parse)

In [23]: df
Out[23]:
      coords
0  12.216667
1  32.087222
2 -30.123000

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lat_lon_parser-1.3.1.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

lat_lon_parser-1.3.1-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

Details for the file lat_lon_parser-1.3.1.tar.gz.

File metadata

  • Download URL: lat_lon_parser-1.3.1.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for lat_lon_parser-1.3.1.tar.gz
Algorithm Hash digest
SHA256 62b8191e72150a7bf5d55fe6a8dddf3e20dd4937a995130f74832cd7ede39e91
MD5 7554ec46472f77fe0fd8726bdcfe7b67
BLAKE2b-256 0058879bcefdcec8ea62501270ac4475e75f72b54a32adb3a769c5ba5b10f535

See more details on using hashes here.

Provenance

File details

Details for the file lat_lon_parser-1.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for lat_lon_parser-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e2abfff8a81de4b4db2c11a02867c5cd8b057a978e7b03c178abdeaa627e8ba8
MD5 9e7f1e24112de13d67c412a392f0dd0b
BLAKE2b-256 4f61a4fda4c2dd7f84814647ce2124edc24dd2c313f4ac0aad786064d5ab9d82

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page