모듈: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 = "좌표: " .. slocal 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" orconcatenated == "EN" or concatenated == "WN" or concatenated == "ES" or concatenated == "WS" thenreturn true; endreturn 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 thenreturn nil, 틀:"parseDec", "경도 값이 없습니다" enderrors = 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/dec2dmscoordinateSpec["dms-long"] = convert_dec2dms( long, "동경 ", "서경 ", mode) -- 틀:Coord/dec2dms if format ~= "" thencoordinateSpec.default = format elsecoordinateSpec.default = "dec" end

return coordinateSpec, errors end

--Helper function, handle optional args. function optionalArg(arg, suplement) if arg ~= nil and arg ~= "" thenreturn arg .. suplement endreturn "" 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 backwardif lat_f == 'E' or lat_f == 'W' thenlocal 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 == "" thentable.insert(errors, {"parseDMS", "위도 값이 없습니다" }) endif 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 thenif lat_f:upper() == 'S' then lat_d = '-' .. lat_d; endif 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/dms2deccoordinateSpec["dec-long"] = convert_dms2dec(long_f, long_d, long_m, long_s) -- 틀:Coord/dms2dec

if format ~= "" thencoordinateSpec.default = format elsecoordinateSpec.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 nilreturn "에러. 인자가 없습니다" endif args["name"] ~= "" and args["name"] ~= nil thenuriComponents = uriComponents .. "&title=" .. mw.uri.encode(coordinateSpec["name"]) endlocal geodmshtml = ''.. '' .. coordinateSpec["dms-lat"] .. ' '.. '' ..coordinateSpec["dms-long"] .. ''.. ''

local lat = tonumber( coordinateSpec["dec-lat"] ) or 0if lat < 0 then-- FIXME this breaks the pre-existing precisiongeodeclat = "남위 " .. coordinateSpec["dec-lat"]:sub(2) .. "°" elsegeodeclat = "북위 " .. (coordinateSpec["dec-lat"] or 0) .. "°" end

local long = tonumber( coordinateSpec["dec-long"] ) or 0if long < 0 then-- FIXME does not handle unicode minusgeodeclong = "서경 " .. coordinateSpec["dec-long"]:sub(2) .. "°" elsegeodeclong = "동경 " .. (coordinateSpec["dec-long"] or 0) .. "°" endlocal geodechtml = ''.. geodeclat .. ' '.. geodeclong.. ''

local geonumhtml = ''.. coordinateSpec["dec-lat"] .. '; '.. coordinateSpec["dec-long"].. ''

local inner;inner = '' .. geodmshtml .. ''.. ''.. '';

if args["name"] == "" or args["name"] == nil theninner = inner .. geodechtml .. ' / ' .. geonumhtml .. ''

elseinner = inner .. '' .. geodechtml .. ' / ' .. geonumhtml .. ''.. ' ('.. args["name"] .. ')'

end

return '' .. globalFrame:preprocess('..uriComponents .. ' ' .. inner .. '') .. ''

end

--[[ Formats any error messages generated for display ]] function errorPrinter(errors) local result = ""for i,v in ipairs(errors) dolocal errorHTML = ''result = result .. errorHTML .. "
" endreturn 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 == "" thendefault = "dec" endif default == mode thenreturn "geo-default" elsereturn "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 logicreturn errorPrinter( 틀:"formatTest", "위도 값이 없습니다" ) elseif args[4] == "" and args[5] == "" and args[6] == "" then-- dec logicresult, errors = parseDec( args[1], args[2], args['format'] )if result == nil thenreturn errorPrinter( errors ); end result.param = table.concat( {args[1], "_N_", args[2], "_E_", args[3] } ); elseif dmsTest(args[4], args[8]) then-- dms logicresult, 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] ~= thentable.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } ); end elseif dmsTest(args[3], args[6]) then-- dm logicresult, 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] ~= thentable.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } ); end elseif dmsTest(args[2], args[4]) then-- d logicresult, 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] ~= thentable.insert( errors, { 'formatTest', '추가적인 인자가 있습니다' } ); end else-- Errorreturn errorPrinter( 틀:"formatTest", "알 수 없는 인자 형식" ) endresult.name = args["name"]local extra_param = {'dim', 'globe', 'scale', 'region', 'source', 'type'}for _, v in ipairs( extra_param ) doif (args[v] or ) ~= then table.insert( errors, {'formatTest', 'Parameter: "' .. v .. '=" should be "' .. v .. ':"' } ); end endif #errors == 0 thenreturn specPrinter( args, result ) elsereturn 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 0local postfixif coord >= 0 thenprefix = firstPrefix elseprefix = secondPrefix end

precision = precision:lower();if precision == "dms" thenreturn prefix .. convert_dec2dms_dms( math.abs( coord ) ); elseif precision == "dm" thenreturn prefix .. convert_dec2dms_dm( math.abs( coord ) ); elseif precision == "d" thenreturn 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 % 60coordinate = math.floor( (coordinate - s) / 60 );local m = coordinate % 60coordinate = 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 0local minutes = tonumber(minutes_str) or 0local seconds = tonumber(seconds_str) or 0local factorif direction == "N" or direction == "E" thenfactor = 1 elsefactor = -1 endlocal precision = 0if seconds_str ~= nil and seconds_str ~= thenprecision = 5 + math.max( math_mod._precision(seconds_str), 0 ); elseif minutes_str ~= nil and minutes_str ~= thenprecision = 3 + math.max( math_mod._precision(minutes_str), 0 ); elseprecision = math.max( math_mod._precision(degrees_str), 0 ); endlocal 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 thenif lat_d < 0 thentable.insert(errors, {source, "남북이 지정된 상태에서 위도 값이 0보다 작습니다"}) endif long_d < 0 thentable.insert(errors, {source, "동서가 지정된 상태에서 경도 값이 0보다 작습니다"}) end--[[ #coordinates is inconsistent about whether this is an error. If globe: isspecified, it won't error on this condition, but otherwise it will.For not simply disable this check.if long_d > 180 thentable.insert(errors, {source, "longitude degrees > 180 with hemisphere flag"}) end]] end if lat_d > 90 thentable.insert(errors, {source, "위도 도가 90보다 큽니다"}) endif lat_d < -90 thentable.insert(errors, {source, "위도 도가 -90보다 작습니다"}) endif lat_m >= 60 thentable.insert(errors, {source, "위도 분이 60보다 크거나 같습니다"}) endif lat_m < 0 thentable.insert(errors, {source, "위도 분이 0보다 작습니다"}) endif lat_s >= 60 thentable.insert(errors, {source, "위도 초가 60보다 크거나 같습니다"}) endif lat_s < 0 thentable.insert(errors, {source, "위도 초가 0보다 작습니다"}) endif long_d >= 360 thentable.insert(errors, {source, "경도 값이 360보다 크거나 같습니다"}) endif long_d <= -360 thentable.insert(errors, {source, "경도 값이 -360보다 작거나 같습니다"}) endif long_m >= 60 thentable.insert(errors, {source, "경도 분이 60보다 크거나 같습니다"}) endif long_m < 0 thentable.insert(errors, {source, "경도 분이 0보다 작습니다"}) endif long_s >= 60 thentable.insert(errors, {source, "경도 초가 60보다 크거나 같습니다"}) endif long_s < 0 thentable.insert(errors, {source, "경도 초가 0보다 작습니다"}) endreturn 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 = framelocal 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 thenreturn 'd' elseif precision <= 2 thenreturn 'dm'; elsereturn '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 = framelocal 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 = framelocal args = frame.argsif args[1] == nil thenlocal pFrame = frame:getParent();args = pFrame.args;for k,v in pairs( frame.args ) doargs[k] = v; end endfor i=1,10 do if args[i] == nil then args[i] = "" elseargs[i] = args[i]:match( '^%s*(.-)%s*$' ); --remove whitespace end endargs['format'] = args['format'] or ;local contents = formatTest(args)local Notes = args.notes or ""local Display = string.lower(args.display or "inline")if Display == thenDisplay = 'inline'; endlocal text = if string.find( Display, 'inline' ) ~= nil or Display == 'i' or Display == 'it' or Display == 'ti' thentext = displayinline(contents, Notes) endif string.find( Display, 'title' ) ~= nil or Display == 't' or Display == 'it' or Display == 'ti' thentext = text .. displaytitle(contents, Notes) endreturn text end

return coordinates