모듈:Coordinates

--[[
This module is intended to replace the functionality of
{{#coordinates:||||||||
|
|name=
}} and related
templates. It provides several methods, including

 : General function formatting and displaying
coordinate values.

 : Simple function for converting decimal
degree values to DMS format.

 : Simple function for converting DMS format
to decimal degree format.

]]

math_mod = require( "Module:Math" );
globalFrame = nil

coordinates = {};

--[[ Helper function, replacement for 틀:Coord/display/title ]]
function displaytitle (s, notes)

local l = "좌표: " .. s

local co = '';

return '' .. co .. '';

end

--[[ Helper function, Replacement for 틀:Coord/display/inline ]]
function displayinline (s, notes)

return s .. notes

end

--Helper function, used in detecting DMS formatting
local dmsTest = function(first, second)

local concatenated = first:upper() .. second:upper();

if concatenated == "NE" or concatenated == "NW" or concatenated == "SE" or concatenated == "SW" or

concatenated == "EN" or concatenated == "WN" or concatenated == "ES" or concatenated == "WS" then

return true;

end

return false;

end

--[[
parseDec

Transforms decimal format latitude and longitude into the a
structure to be used in displaying coordinates
]]
function parseDec( lat, long, format )

local coordinateSpec = {}

local errors = {}

if long == "" or long == nil then

return nil, 틀:"parseDec", "경도 값이 없습니다"

end

errors = validate( lat, nil, nil, long, nil, nil, 'parseDec', false );

coordinateSpec["dec-lat"] = lat;

coordinateSpec["dec-long"] = long;

local mode = coordinates.determineMode( lat, long );

coordinateSpec["dms-lat"] = convert_dec2dms( lat, "북위 ", "남위 ", mode) -- 틀:Coord/dec2dms

coordinateSpec["dms-long"] = convert_dec2dms( long, "동경 ", "서경 ", mode) -- 틀:Coord/dec2dms

if format ~= "" then

coordinateSpec.default = format

else

coordinateSpec.default = "dec"

end

return coordinateSpec, errors

end

--Helper function, handle optional args.
function optionalArg(arg, suplement)

if arg ~= nil and arg ~= "" then

return arg .. suplement

end

return ""

end

--[[
parseDMS

Transforms degrees, minutes, seconds format latitude and longitude
into the a structure to be used in displaying coordinates
]]
function parseDMS( lat_d, lat_m, lat_s, lat_f, long_d, long_m, long_s, long_f, format )

local coordinateSpec = {}

local errors = {}

local format_en2ko = {

N = "북위 ",

S = "남위 ",

E = "동경 ",

W = "서경 "

}

lat_f = lat_f:upper();

long_f = long_f:upper();

-- Check if specified backward

if lat_f == 'E' or lat_f == 'W' then

local t_d, t_m, t_s, t_f;

t_d = lat_d;

t_m = lat_m;

t_s = lat_s;

t_f = lat_f;

lat_d = long_d;

lat_m = long_m;

lat_s = long_s;

lat_f = long_f;

long_d = t_d;

long_m = t_m;

long_s = t_s;

long_f = t_f;

end

errors = validate( lat_d, lat_m, lat_s, long_d, long_m, long_s, 'parseDMS', true );

if long_d == nil or long_d == "" then

table.insert(errors, {"parseDMS", "위도 값이 없습니다" })

end

if lat_m == nil and lat_s == nil and long_m == nil and long_s == nil and #errors == 0 then

if math_mod._precision( lat_d ) > 0 or math_mod._precision( long_d ) > 0 then

if lat_f:upper() == 'S' then

lat_d = '-' .. lat_d;

end

if long_f:upper() == 'W' then

long_d = '-' .. long_d;

end

return parseDec( lat_d, long_d, format );

end

end

coordinateSpec["dms-lat"] = format_en2ko[lat_f] .. lat_d.."° "..optionalArg(lat_m,"′ ") .. optionalArg(lat_s,"″")

coordinateSpec["dms-long"] = format_en2ko[long_f] .. long_d.."° "..optionalArg(long_m,"′ ") .. optionalArg(long_s,"″")

coordinateSpec["dec-lat"] = convert_dms2dec(lat_f, lat_d, lat_m, lat_s) -- 틀:Coord/dms2dec

coordinateSpec["dec-long"] = convert_dms2dec(long_f, long_d, long_m, long_s) -- 틀:Coord/dms2dec

if format ~= "" then

coordinateSpec.default = format

else

coordinateSpec.default = "dms"

end

return coordinateSpec, errors

end

--[[
specPrinter

Output formatter. Takes the structure generated by either parseDec
or parseDMS and formats it for inclusion on Wikipedia.
]]
function specPrinter(args, coordinateSpec)

local uriComponents = coordinateSpec["param"]

if uriComponents == "" then

-- RETURN error, should never be empty or nil

return "에러. 인자가 없습니다"

end

if args["name"] ~= "" and args["name"] ~= nil then

uriComponents = uriComponents .. "&title=" .. mw.uri.encode(coordinateSpec["name"])

end

local geodmshtml = ''

.. '' .. coordinateSpec["dms-lat"] .. ' '

.. '' ..coordinateSpec["dms-long"] .. ''

.. ''

local lat = tonumber( coordinateSpec["dec-lat"] ) or 0

if lat < 0 then

-- FIXME this breaks the pre-existing precision

geodeclat = "남위 " .. coordinateSpec["dec-lat"]:sub(2) .. "°"

else

geodeclat = "북위 " .. (coordinateSpec["dec-lat"] or 0) .. "°"

end

local long = tonumber( coordinateSpec["dec-long"] ) or 0

if long < 0 then

-- FIXME does not handle unicode minus

geodeclong = "서경 " .. coordinateSpec["dec-long"]:sub(2) .. "°"

else

geodeclong = "동경 " .. (coordinateSpec["dec-long"] or 0) .. "°"

end

local geodechtml = ''

.. geodeclat .. ' '

.. geodeclong

.. ''

local geonumhtml = ''

.. coordinateSpec["dec-lat"] .. '; '

.. coordinateSpec["dec-long"]

.. ''

local inner;

inner = '' .. geodmshtml .. ''

.. ''

.. '';

if args["name"] == "" or args["name"] == nil then

inner = inner .. geodechtml

.. ' / ' .. geonumhtml .. ''

else

inner = inner .. '' .. geodechtml

.. ' / ' .. geonumhtml .. ''

.. ' ('

.. args["name"] .. ')'

end

return '' .. globalFrame:preprocess(

'[//tools.wmflabs.org/geohack/geohack.php?language=ko&pagename=%EB%AA%A8%EB%93%88:Coordinates&params=' ..

uriComponents .. ' ' .. inner .. ']') .. ''

end

--[[
Formats any error messages generated for display
]]
function errorPrinter(errors)

local result = ""

for i,v in ipairs(errors) do

local errorHTML = ''

result = result .. errorHTML .. "
"

end

return result

end

--[[
Determine the required CSS class to display coordinates

Usually geo-nondefault is hidden by CSS, unless a user has overridden this for himself
default is the mode as specificied by the user when calling the
{{#coordinates:||||||||
|
|name=
}} template
mode is the display mode (dec or dms) that we will need to determine the css class for
]]
function displayDefault(default, mode)

if default == "" then

default = "dec"

end

if default == mode then

return "geo-default"

else

return "geo-nondefault"

end

end

--[[
Check the input arguments for coord to determine the kind of data being provided
and then make the necessary processing.
]]
function formatTest(args)

local result, errors;

local primary = false;

if args[1] == "" then

-- no lat logic

return errorPrinter( 틀:"formatTest", "위도 값이 없습니다" )

elseif args[4] == "" and args[5] == "" and args[6] == "" then

-- dec logic

result, errors = parseDec( args[1], args[2], args['format'] )

if result == nil then

return errorPrinter( errors );

end

result.param = table.concat( {args[1], "_N_", args[2], "_E_", args[3] } );

elseif dmsTest(args[4], args[8]) then

-- dms logic

result, errors = parseDMS( args[1], args[2], args[3], args[4],

args[5], args[6], args[7], args[8], args['format'] )

result.param = table.concat( { args[1], args[2], args[3], args[4], args[5],

args[6], args[7], args[8], args[9] } , '_' );

if args[10] ~= then

table.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } );

end

elseif dmsTest(args[3], args[6]) then

-- dm logic

result, errors = parseDMS( args[1], args[2], nil, args[3],

args[4], args[5], nil, args[6], args['format'] )

result.param = table.concat( { args[1], args[2], args[3], args[4], args[5],

args[6], args[7] } , '_' );

if args[8] ~= then

table.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } );

end

elseif dmsTest(args[2], args[4]) then

-- d logic

result, errors = parseDMS( args[1], nil, nil, args[2],

args[3], nil, nil, args[4], args['format'] )

result.param = table.concat( { args[1], args[2], args[3], args[4], args[5] } , '_' );

if args[6] ~= then

table.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } );

end

else

-- Error

return errorPrinter( 틀:"formatTest", "알 수 없는 인자 형식" )

end

result.name = args["name"]

local extra_param = {'dim', 'globe', 'scale', 'region', 'source', 'type'}

for _, v in ipairs( extra_param ) do

if (args[v] or ) ~= then

table.insert( errors, {'formatTest', 'Parameter: "' .. v .. '=" should be "' .. v .. ':"' } );

end

end

if #errors == 0 then

return specPrinter( args, result )

else

return specPrinter( args, result ) .. " " .. errorPrinter(errors) .. ;

end

end

--[[
Helper function, convert decimal latitude or longitude to
degrees, minutes, and seconds format based on the specified precision.
]]
function convert_dec2dms(coordinate, firstPrefix, secondPrefix, precision)

local coord = tonumber(coordinate) or 0

local postfix

if coord >= 0 then

prefix = firstPrefix

else

prefix = secondPrefix

end

precision = precision:lower();

if precision == "dms" then

return prefix .. convert_dec2dms_dms( math.abs( coord ) );

elseif precision == "dm" then

return prefix .. convert_dec2dms_dm( math.abs( coord ) );

elseif precision == "d" then

return prefix .. convert_dec2dms_d( math.abs( coord ) );

end

end

--Helper function, convert decimal to degrees
function convert_dec2dms_d(coordinate)

local d = math_mod._round( coordinate, 0 ) .. "°"

return d .. ""

end

--Helper function, convert decimal to degrees and minutes
function convert_dec2dms_dm(coordinate)

coordinate = math_mod._round( coordinate * 60, 0 );

local m = coordinate % 60;

coordinate = math.floor( (coordinate - m) / 60 );

local d = coordinate % 360 .."° "

return d .. string.format( "%02d′", m )
end

--Helper function, convert decimal to degrees, minutes, and seconds
function convert_dec2dms_dms(coordinate)

coordinate = math_mod._round( coordinate * 60 * 60, 0 );

local s = coordinate % 60

coordinate = math.floor( (coordinate - s) / 60 );

local m = coordinate % 60

coordinate = math.floor( (coordinate - m) / 60 );

local d = coordinate % 360 .."° "

return d .. string.format( "%02d′ ", m ) .. string.format( "%02d″", s )

end

--[[
Convert DMS format into a N or E decimal coordinate
]]
function convert_dms2dec(direction, degrees_str, minutes_str, seconds_str)

local degrees = tonumber(degrees_str) or 0

local minutes = tonumber(minutes_str) or 0

local seconds = tonumber(seconds_str) or 0

local factor

if direction == "N" or direction == "E" then

factor = 1

else

factor = -1

end

local precision = 0

if seconds_str ~= nil and seconds_str ~= then

precision = 5 + math.max( math_mod._precision(seconds_str), 0 );

elseif minutes_str ~= nil and minutes_str ~= then

precision = 3 + math.max( math_mod._precision(minutes_str), 0 );

else

precision = math.max( math_mod._precision(degrees_str), 0 );

end

local decimal = factor * (degrees+(minutes+seconds/60)/60)

return string.format( "%." .. precision .. "f", decimal ) -- not tonumber since this whole thing is string based.

end

--[[
Checks input values to for out of range errors.
]]
function validate( lat_d, lat_m, lat_s, long_d, long_m, long_s, source, strong )

local errors = {};

lat_d = tonumber( lat_d ) or 0;

lat_m = tonumber( lat_m ) or 0;

lat_s = tonumber( lat_s ) or 0;

long_d = tonumber( long_d ) or 0;

long_m = tonumber( long_m ) or 0;

long_s = tonumber( long_s ) or 0;

if strong then

if lat_d < 0 then

table.insert(errors, {source, "남북이 지정된 상태에서 위도 값이 0보다 작습니다"})

end

if long_d < 0 then

table.insert(errors, {source, "동서가 지정된 상태에서 경도 값이 0보다 작습니다"})

end

--[[

1. coordinates is inconsistent about whether this is an error. If globe: is

specified, it won't error on this condition, but otherwise it will.

For not simply disable this check.

if long_d > 180 then

table.insert(errors, {source, "longitude degrees > 180 with hemisphere flag"})

end

]]

end

if lat_d > 90 then

table.insert(errors, {source, "위도 도가 90보다 큽니다"})

end

if lat_d < -90 then

table.insert(errors, {source, "위도 도가 -90보다 작습니다"})

end

if lat_m >= 60 then

table.insert(errors, {source, "위도 분이 60보다 크거나 같습니다"})

end

if lat_m < 0 then

table.insert(errors, {source, "위도 분이 0보다 작습니다"})

end

if lat_s >= 60 then

table.insert(errors, {source, "위도 초가 60보다 크거나 같습니다"})

end

if lat_s < 0 then

table.insert(errors, {source, "위도 초가 0보다 작습니다"})

end

if long_d >= 360 then

table.insert(errors, {source, "경도 값이 360보다 크거나 같습니다"})

end

if long_d <= -360 then

table.insert(errors, {source, "경도 값이 -360보다 작거나 같습니다"})

end

if long_m >= 60 then

table.insert(errors, {source, "경도 분이 60보다 크거나 같습니다"})

end

if long_m < 0 then

table.insert(errors, {source, "경도 분이 0보다 작습니다"})

end

if long_s >= 60 then

table.insert(errors, {source, "경도 초가 60보다 크거나 같습니다"})

end

if long_s < 0 then

table.insert(errors, {source, "경도 초가 0보다 작습니다"})

end

return errors;
end

--[[
dec2dms

Wrapper to allow templates to call dec2dms directly.

Usage:

틀:Invoke:Coordinates

decimal_coordinate is converted to DMS format. If positive, the positive_suffix
is appended (typical N or E), if negative, the negative suffix is appended. The
specified precision is one of 'D', 'DM', or 'DMS' to specify the level of detail
to use.
]]
function coordinates.dec2dms(frame)

globalFrame = frame

local coordinate = frame.args[1]

local firstPrefix = frame.args[2]

local secondPrefix = frame.args[3]

local precision = frame.args[4]

return convert_dec2dms(coordinate, firstPrefix, secondPrefix, precision)

end

--[[
Helper function to determine whether to use D, DM, or DMS
format depending on the precision of the decimal input.
]]
function coordinates.determineMode( value1, value2 )

local precision = math.max( math_mod._precision( value1 ), math_mod._precision( value2 ) );

if precision <= 0 then

return 'd'

elseif precision <= 2 then

return 'dm';

else

return 'dms';

end

end

--[[
dms2dec

Wrapper to allow templates to call dms2dec directly.

Usage:

틀:Invoke:Coordinates

Converts DMS values specified as degrees, minutes, seconds too decimal format.
direction_flag is one of N, S, E, W, and determines whether the output is
positive (i.e. N and E) or negative (i.e. S and W).
]]
function coordinates.dms2dec(frame)

globalFrame = frame

local direction = frame.args[1]

local degrees = frame.args[2]

local minutes = frame.args[3]

local seconds = frame.args[4]

return convert_dms2dec(direction, degrees, minutes, seconds)

end

--[[
coord

Main entry point for Lua function to replace
{{#coordinates:||||||||
|
|name=
}}

Usage:

틀:Invoke:Coordinates

틀:Invoke:Coordinates

틀:Invoke:Coordinates

...

Refer to
{{#coordinates:||||||||
|
|name=
}} documentation page for many additional parameters and

configuration options.

Note: This function provides the visual display elements of
{{#coordinates:||||||||
|
|name=
}}. In
order to load coordinates into the database, the {{#coordinates:}} parser
function must also be called, this is done automatically in the Lua
version of
{{#coordinates:||||||||
|
|name=
}}.
]]
function coordinates.coord(frame)

globalFrame = frame

local args = frame.args

if args[1] == nil then

local pFrame = frame:getParent();

args = pFrame.args;

for k,v in pairs( frame.args ) do

args[k] = v;

end

end

for i=1,10 do

if args[i] == nil then

args[i] = ""

else

args[i] = args[i]:match( '^%s*(.-)%s*$' ); --remove whitespace

end

end

args['format'] = args['format'] or ;

local contents = formatTest(args)

local Notes = args.notes or ""

local Display = string.lower(args.display or "inline")

if Display == then

Display = 'inline';

end

local text =

if string.find( Display, 'inline' ) ~= nil or Display == 'i' or

Display == 'it' or Display == 'ti' then

text = displayinline(contents, Notes)

end

if string.find( Display, 'title' ) ~= nil or Display == 't' or

Display == 'it' or Display == 'ti' then

text = text .. displaytitle(contents, Notes)

end

return text

end

return coordinates