WikiAnesthesia:Calculators guide - Revision history

Chris.Rishel at 04:26, 12 July 2022

2022-07-12T04:26:00Z

← Older revision		Revision as of 21:26, 11 July 2022
Line 9:		Line 9:
	**E.g. lean body weight, weight-based drug dosing, equipment sizing, fluid management, cardiac output		**E.g. lean body weight, weight-based drug dosing, equipment sizing, fluid management, cardiac output
	*Many calculations in anesthesia are computed using a relatively limited set of patient variables		*Many calculations in anesthesia are computed using a relatively limited set of patient variables
	**E.g. weight, height, age, ~~gender~~		**E.g. weight, height, age, sex

	This allows optimizations for real-time clinical use in the following ways:		This allows optimizations for real-time clinical use in the following ways:
Line 22:		Line 22:
	===List of calculators===		===List of calculators===

	*[[~~Anatomy and physiology calculator~~]]		*[[Body composition calculations]]
	*[[Drug dosage ~~calculator~~]]		*[[Cardiovascular calculations]]
	*[[Equipment ~~sizing calculator~~]]		*[[Drug dosage calculations]]
	*[[Fluid management ~~calculator~~]]		*[[Equipment size calculations]]
			*[[Fluid management calculations]]
			*[[Neuro calculations]]
			*[[Respiratory calculations]]

	==Contributing to calculators==		==Contributing to calculators==
Line 44:		Line 47:

	If approved, you will be given developer access on a sandbox server to develop and test your modifications. When ready, your code will be reviewed and considered for implementation on the live site.		If approved, you will be given developer access on a sandbox server to develop and test your modifications. When ready, your code will be reviewed and considered for implementation on the live site.
	*

	==Calculator development==		==Calculator development==
Line 58:		Line 60:
	Calculators must be declared as gadgets in the [[MediaWiki:Gadgets-definition\|Gadgets-definition]] page. The gadget definition should specify any additional dependencies on existing gadgets (calculator-core is automatically included). Some examples of common dependencies include:		Calculators must be declared as gadgets in the [[MediaWiki:Gadgets-definition\|Gadgets-definition]] page. The gadget definition should specify any additional dependencies on existing gadgets (calculator-core is automatically included). Some examples of common dependencies include:

	*calculator-patients-patientInput: Adds a sticky input panel for patient weight, height, age, and ~~gender~~ below the header		*calculator-patients-patientInput: Adds a sticky input panel for patient weight, height, age, and sex below the header
	*calculator-patients-~~weightCalculations~~: Makes calculations for lean and ideal body weight available		*calculator-patients-bodyComposition: Makes calculations for lean and ideal body weight available
	*calculator-drugs-data: Loads the database of drug data		*calculator-drugs-data: Loads the database of drug data

Line 104:		Line 106:

	====<nowiki><calculationcategory></nowiki>====		====<nowiki><calculationcategory></nowiki>====
	The <code><nowiki><calculationcategory></nowiki></code> tag allows multiple calculations to be grouped, and defines the categories used by the search functionality. Calculations within a category should be contained with the open and close tags.		The <code><nowiki><calculationcategory></nowiki></code> tag allows multiple calculations to be grouped, and defines the categories used by the search functionality. Calculations within a category should be contained with the open and close tags.
	=====Arguments=====		=====Arguments=====

Chris.Rishel at 14:39, 19 March 2022

2022-03-19T14:39:40Z

← Older revision		Revision as of 07:39, 19 March 2022
Line 25:		Line 25:
	*[[Drug dosage calculator]]		*[[Drug dosage calculator]]
	*[[Equipment sizing calculator]]		*[[Equipment sizing calculator]]
			*[[Fluid management calculator]]

	==Contributing to calculators==		==Contributing to calculators==

Chris.Rishel at 03:37, 27 September 2021

2021-09-27T03:37:56Z

← Older revision		Revision as of 20:37, 26 September 2021
Line 67:		Line 67:
	=== Adding calculators to an article===		=== Adding calculators to an article===
	Calculators are added to articles using a set of custom tags. It is generally easiest to implement calculators with the editor in source mode.		Calculators are added to articles using a set of custom tags. It is generally easiest to implement calculators with the editor in source mode.

			=== List of calculator tags ===

	====<nowiki><calculatormodule></nowiki>====		====<nowiki><calculatormodule></nowiki>====

Chris.Rishel at 03:37, 27 September 2021

2021-09-27T03:37:13Z

Show changes

Chris.Rishel at 08:08, 20 September 2021

2021-09-20T08:08:49Z

← Older revision		Revision as of 01:08, 20 September 2021
Line 36:		Line 36:

	====Applying for developer access====		====Applying for developer access====
	If you would like to more substantially contribute to calculator development, please send a message to the [[User:Chris.Rishel\|editor-in-chief ~~(Chris Rishel)~~]] and include:		If you would like to more substantially contribute to calculator development, please send a message to the [[User:Chris.Rishel\|editor-in-chief]] and include:

	*A brief description of your technical background		*A brief description of your technical background

Chris.Rishel at 07:52, 20 September 2021

2021-09-20T07:52:22Z

← Older revision		Revision as of 00:52, 20 September 2021
Line 1:		Line 1:
	{{DISPLAYTITLE:Calculators guide}}		{{DISPLAYTITLE:Calculators guide}}

			'''Calculators''' on WikiAnesthesia are interactive tools which perform clinical calculations across a wide range of topics of interest in anesthesia.

			===About the calculators===
			Calculators on WikiAnesthesia differ from many other existing calculator apps by leveraging several unique characteristics of the practice of anesthesia:

			*Each patient may require many independent calculations to be performed
			**E.g. lean body weight, weight-based drug dosing, equipment sizing, fluid management, cardiac output
			*Many calculations in anesthesia are computed using a relatively limited set of patient variables
			**E.g. weight, height, age, gender

			This allows optimizations for real-time clinical use in the following ways:

			*The results of many calculations can be displayed in a single, organized, compact, searchable interface
			*User-provided values for patient variables are cached for 8 hours
			**Patient data only needs to be entered once throughout the intraoperative period and will automatically be applied to all calculators on the site

			===Using the calculators===
			The most commonly used calculators can be found in the calculators menu (<span class="fas fa-calculator"></span>) in the upper right of the header. A complete list of available calculators includes:

			====List of calculators====

			*[[Anatomy and physiology calculator]]
			*[[Drug dosage calculator]]
			*[[Equipment sizing calculator]]

			===Contributing to calculators===
			Because calculators are interactive tools which run JavaScript code locally on users' computers, modification of calculator code is restricted to [[Special:ListUsers/sysop\|developers of WikiAnesthesia]]. Users can contribute to calculators by either suggesting changes using the discussion page or apply for developer access to modify existing or create new calculators.

			====Suggesting changes====
			Any user may use the calculator's discussion page to make suggestions about how to improve that calculator. To be most helpful, please include any specific details and relevant references which would facilitate evidenced-based implementation by one of our developers. Some good examples of feedback include:

			*A drug or dose for a specific population/indication/route is missing from the [[drug dosage calculator]]
			*Additional calculation(s) which could be added to the [[anatomy and physiology calculator]]

			====Applying for developer access====
			If you would like to more substantially contribute to calculator development, please send a message to the [[User:Chris.Rishel\|editor-in-chief (Chris Rishel)]] and include:

			*A brief description of your technical background
			**Experience with JavaScript and jQuery would be particularly helpful
			*What ideas you have for improving and/or adding to the calculators provided by WikiAnesthesia

			If approved, you will be given developer access on a sandbox server to develop and test your modifications. When ready, your code will be reviewed and considered for implementation on the live site.
			*

			===Calculator development===

			* Calculators are implemented as MediaWiki gadgets, which consist of javascript and/or css files stored as wiki pages in the MediaWiki namespace
			** This allows the code to have similar collaboration, history tracking, and version control as normal wiki pages
			** See the [[mediawikiwiki:Extension:Gadgets\|gadgets extension page]] for background information about how gadgets work
			* The core functionality of the calculators platform is provided by the "calculator-core" gadget
			** Contained in [[MediaWiki:Gadget-calculator-core.js\|Gadget-calculator-core.js]] and [[MediaWiki:Gadget-calculator-core.css\|Gadget-calculator-core.css]]
			** Calculator functions and data are stored in the <code>mw.calculators</code> property of the global <code>mw</code> MediaWiki javascript object

			==== Creating a new calculator ====
			Calculators must be declared as gadgets in the [[MediaWiki:Gadgets-definition\|Gadgets-definition]] page. The gadget definition should specify any additional dependencies on existing gadgets (calculator-core is automatically included). Some examples of common dependencies include:

			* calculator-patients-patientInput: Adds a sticky input panel for patient weight, height, age, and gender below the header
			* calculator-patients-weightCalculations: Makes calculations for lean and ideal body weight available
			* calculator-drugs-data: Loads the database of drug data

			Calculators may be added to the calculator menu by editing the [[MediaWiki:Calculators-definition\|calculators-definition]] page

			Eventually this guide may expand to include more specific details about calculator development, but for now, the best way to learn would be to examine the code of existing calculators to see how they work.

Chris.Rishel: Created page with "{{DISPLAYTITLE:Calculators guide}}"

2021-09-20T04:15:21Z

Created page with "{{DISPLAYTITLE:Calculators guide}}"

New page