Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Module:Data

From Kerbal Space Program 2 Wiki
Revision as of 03:39, 28 November 2024 by KiwiShark (talk | contribs) (forgot p.)

The Data module exists to translate information from Data: pages to templates/articles.

Arguments

<1> (Entity): This argument is taken as the title of the intended Data: page to search through.

E.g.: "Kerbol", "LW-Sw "SWERV""

<2+> (Parameter chain): Arguments 2 and beyond define the parameter chain to search on the data page.

E.g.: "mass", "max_temp", "modules|engine|isp_vac", "modules|generator|outputs|units"

Functions

getData: The primary function of the module. Accepts the full argument set to determine the parameter to return from the subject.

getFuelLabels: Used for engine infobox construction. Accepts a part name (only works for engines) for <1> and optionally "alt" for <2>. Returns a line-break separated list of the propellant names used by an engine mode. Should probably be moved to a different Module.

getFuelValues: Used for engine infobox construction. Accepts a part name (only works for engines) for <1> and optionally "alt" for <2>. Returns a line-break separated list of the propellant use rates of an engine mode. Should probably be moved to a different Module.

Examples

A list of example JSON sets can be found at Data:Example.

{{#invoke:Data|getData|LV-SW "SWERV"|mass}} - Returns the mass of the "SWERV" in tons, 10.00.

{{#invoke:Data|getData|LV-3000 "Tuba"|modules|engine|thrust|vac}} - Returns the vacuum thrust of the "Tuba" in kilonewtons, 510.0.


local p = {}
local getArgs = require('Module:Arguments').getArgs

-- subject: The subject entity to get data from. 
--- E.g., "Kerbol", "LW-Sw "SWERV""
-- args: The parameter / parameter chain to access from the data page. 
--- E.g., "mass", "max_temp", "modules|engine|isp_vac", "modules|generator|outputs|units"

function p.getData(frame)
	-- Get arguments from the invoke
	local args = getArgs(frame, {frameOnly = true}) -- E.g., args = {"Example", "modules", "engine", "isp", "vac"}
	-- Pass arguments to the helper function
	dataJson = p._getData(args)
	return dataJson--[args[2]]["engine"]["isp"]["vac"]
end

function p._getData(args)
	-- Load the data from the JSON page, parsed as a table of tables
	local dataJson = mw.loadJsonData("Data:"..args[1])
	
	-- Iterate through dataJson using the args values as keys to 
	-- step down into the table per argument
	for k, v in pairs(args) do
		if k > 1 then
			dataJson = dataJson[v]
		end
	end
	--local temp = "START:"
	--for k, v in pairs(args) do
	--	temp = temp.." "..v
	--end
	--dataJson = temp
	-- Send the final, requested value back to the main function
	return dataJson
end

function p._formatResource(resource)
	if resource == "monopropellant" then return "Monopropellant" end
	if resource == "methane" then return "Methane" end
	if resource == "oxidizer" then return "Oxidizer" end
	if resource == "solid_fuel" then return "Solid Fuel" end
	if resource == "hydrogen" then return "Hydrogen" end
	if resource == "xenon" then return "Xenon" end
	if resource == "electric_charge" then return "Electric Charge" end
end

function p.getFuelLabels(frame)
	local args = getArgs(frame)	
	propellants = p._getFuelLabels(args)
	return propellants
end

function p._getFuelLabels(args)
	-- Load the data from the JSON page, parsed as a table of tables
	local dataJson = mw.loadJsonData("Data:"..args[1])
	local propellants = ""
	local mode = ""
	
	if args[2] == "alt" then
		mode = dataJson["modules"]["engine"]["alt_mode"]["propellants"]
	else
		mode = dataJson["modules"]["engine"]["propellants"]
	end
		
	for k, v in pairs(mode) do
		--mw.logObject(k)
		if k == "units" then
			mw.logObject(k)
		else
			propellants = propellants..p._formatResource(k).." ("..mode["units"][k]..")<br>"
		end
	end
	return propellants
end

function p.getFuelValues(frame)
	local args = getArgs(frame)	
	propellants = p._getFuelValues(args)
	return propellants
end

function p._getFuelValues(args)
	-- Load the data from the JSON page, parsed as a table of tables
	local dataJson = mw.loadJsonData("Data:"..args[1])
	local propellants = ""
	local mode = ""
	
	if args[2] == "alt" then
		mode = dataJson["modules"]["engine"]["alt_mode"]["propellants"]
	else
		mode = dataJson["modules"]["engine"]["propellants"]
	end
		
	for k, v in pairs(mode) do
		--mw.logObject(k)
		if k == "units" then
			mw.logObject(k)
		else
			propellants = propellants..v.."<br>"
		end
	end
	return propellants
end

	
return p
MediaWiki Appliance - Powered by TurnKey Linux