Independent t test help files

inst/qml/TTestBayesianIndependentSamples.qml

@@ -23,6 +23,9 @@ import JASP.Controls
 import "./common" as Common
 
 Form {
+	info: qsTr("The Bayesian independent samples t-test allows the user to estimate the effect size and test the null hypothesis that the population means of two independent groups are equal.\n") +
+	"## " + "Assumptions" + "\n" + "- Continuous dependent variable.\n" + "- The observations in both groups are a random sample from the population.\n" + "- The dependent variable is normally distributed in both populations.\n" + "- The population variances in the two groups are homogeneous."
+
 	id: form
 	property int framework:	Common.Type.Framework.Bayesian
 
@@ -35,18 +38,18 @@ Form {
 	{
 		preferredHeight: jaspTheme.smallDefaultVariablesFormHeight
 		AvailableVariablesList { name: "allVariablesList" }
-		AssignedVariablesList { name: "dependent";	title: qsTr("Dependent Variables"); allowedColumns: ["scale"];	minNumericLevels: 2 }
-		AssignedVariablesList { name: "group";		title: qsTr("Grouping Variable");	allowedColumns: ["nominal"];	minLevels: 2; maxLevels: 2; singleVariable: true }
+		AssignedVariablesList { name: "dependent";	title: qsTr("Dependent Variables"); info: qsTr("In this box the dependent variable is selected."); allowedColumns: ["scale"];	minNumericLevels: 2 }
+		AssignedVariablesList { name: "group";		title: qsTr("Grouping Variable"); info: qsTr("In this box the variable defining the groups is selected.");	allowedColumns: ["nominal"];	minLevels: 2; maxLevels: 2; singleVariable: true }
 	}
 
 	RadioButtonGroup
 	{
 		id:	hypothesis
 		name: "alternative"
 		title: qsTr("Alternative Hypothesis")
-		RadioButton { value: "twoSided";	label: qsTr("Group 1 ≠ Group 2"); checked: true	}
-		RadioButton { value: "greater";	label: qsTr("Group 1 > Group 2")					}
-		RadioButton { value: "less";	label: qsTr("Group 1 < Group 2")					}
+		RadioButton { value: "twoSided";	label: qsTr("Group 1 ≠ Group 2"); info: qsTr("Two-sided alternative hypothesis that the population means are equal. Selected by default"); checked: true	}
+		RadioButton { value: "greater";	label: qsTr("Group 1 > Group 2"); info: qsTr("One-sided alternative hypothesis that the population mean of group one is larger than the population mean of group two.")					}
+		RadioButton { value: "less";	label: qsTr("Group 1 < Group 2"); info: qsTr("One-sided alternative hypothesis that the population mean of group one is smaller than the population mean of group two.")					}
 	}
 
 	Group
@@ -56,28 +59,31 @@ Form {
 
 		CheckBox
 		{
-			name: "priorAndPosteriorPlot";		label: qsTr("Prior and posterior")
+			name: "priorAndPosteriorPlot";		label: qsTr("Prior and posterior"); info: qsTr("Displays the prior and posterior distribution of the effect size after the data is seen.\n") + "\t" + "- Additional info: Adds the Bayes factor computed with the user-defined prior; adds a probability wheel depicting how likely the data is under the null vs. alternative hypothesis; adds the median and the 95% credible interval of the posterior distribution of the effect size."
+
 			CheckBox { name: "priorAndPosteriorPlotAdditionalInfo";		label: qsTr("Additional info"); checked: true }
 			CIField  { name: "priorAndPosteriorPlotCiLevel";	label: qsTr("Credible interval") }
 		}
 
 		CheckBox
 		{
 			enabled: student.checked && priors.defaultPriorsChecked
-			name: "bfRobustnessPlot";	label: qsTr("Bayes factor robustness check")
+			name: "bfRobustnessPlot";	label: qsTr("Bayes factor robustness check"); info: qsTr("Displays the Bayes factor accross different values of cauchy prior width. The scale of the Cauchy prior is varied between 0 and 1.5, creating progressively more uninformative priors.\n") +
+			"\t" + "- Additional info: Adds the Bayes factor computed with the user-defined prior; adds a probability wheel depicting how likely the data is under the null vs. alternative hypothesis; adds the median and the 95% credible interval of the posterior distribution of the effect size.";
 			CheckBox { name: "bfRobustnessPlotAdditionalInfo";	label: qsTr("Additional info"); checked: true }
 		}
 
 		CheckBox
 		{
 			enabled: student.checked && priors.defaultPriorsChecked
-			name: "bfSequentialPlot";		label: qsTr("Sequential analysis")
+			name: "bfSequentialPlot";		label: qsTr("Sequential analysis"); info: qsTr("Displays the development of the Bayes factor as the data come in using the user-defined prior.\n") +
+			"\t" + "- Robustness check: Adds the results of the sequential analysis using the wide (scale=1) and ultrawide prior (scale=sqrt(2)).";
 			CheckBox { name: "bfSequentialPlotRobustness";		label: qsTr("Robustness check") }
 		}
 
 		CheckBox
 		{
-			name: "descriptivesPlot";			label: qsTr("Descriptives")
+			name: "descriptivesPlot";			label: qsTr("Descriptives"); info: qsTr("\n") + "\t" + "- Credible interval: Display central credible intervals. A credible interval shows the probability that the true effect size lies within certain values. The default credible interval is set at 95%."
 			CIField { name: "descriptivesPlotCiLevel";	label: qsTr("Credible interval") }
 		}
 
@@ -88,7 +94,8 @@ Form {
 
 		CheckBox
 		{
-			name: "raincloudPlot"; label: qsTr("Raincloud plots")
+			name: "raincloudPlot"; label: qsTr("Raincloud plots"); info: qsTr("Displays the individual cases (colored dots), box plots, and densities for each group.\n") +
+			"\t" + "- Horizontal display: Changes the orientation of the raincloud plot so that the x-axis represents the dependent variable and the y-axis the grouping variable."
 			CheckBox { name: "raincloudPlotHorizontal"; label: qsTr("Horizontal display") }
 		}
 	}
@@ -103,10 +110,10 @@ Form {
 		RadioButton
 		{
 			id: student
-			value: "student";	label: qsTr("Student"); checked: true}
+			value: "student";	label: qsTr("Student"); info: qsTr("Student's t-test. This option is selected by default."); checked: true}
 		RadioButton
 		{
-			value: "wilcoxon";	label: qsTr("Mann-Whitney"); id: testWilcoxon
+			value: "wilcoxon";	label: qsTr("Mann-Whitney"); info: qsTr("Mann-Whitney test. Use when data is not normally distributed.\n") + "\t" + "- Number of MCMC samples to use"; id: testWilcoxon
 			IntegerField { name: "wilcoxonSamples"; label: qsTr("No. samples"); defaultValue: 1000; min: 100; max: 10000; fieldWidth: 60 }
 		}
 	}
@@ -115,13 +122,13 @@ Form {
 	{
 		name: "naAction"
 		title: qsTr("Missing Values")
-		RadioButton { value: "perDependent";	label: qsTr("Exclude cases per dependent variable"); checked: true }
-		RadioButton { value: "listwise";				label: qsTr("Exclude cases listwise")							}
+		RadioButton { value: "perDependent";	label: qsTr("Exclude cases per dependent variable"); info: qsTr("In case of multiple t-tests within a single analysis, each test will be conducted using all cases with valid data for the dependent variable for the particular t-test. Sample sizes may therefore vary across the multiple t-tests."); checked: true }
+		RadioButton { value: "listwise";				label: qsTr("Exclude cases listwise"); info: qsTr(" In case of multiple t-tests within a single analysis, each t-test will be conducted using only cases with valid data for all dependent variables. Sample size is therefore constant across the multiple t-tests.")							}
 	}
 
 	Group
 	{
-		title: qsTr("Additional Statistics")
+		title: qsTr("Additional Statistics"); info: qsTr("\n") + "- Descriptives: Sample size, sample mean, sample standard deviation, and standard error of the mean for each group."
 		CheckBox { name: "descriptives"; label: qsTr("Descriptives") }
 	}
 

inst/qml/TTestBayesianOneSample.qml

@@ -24,6 +24,8 @@ import "./common" as Common
 
 Form
 {
+	info: qsTr("The paired samples t-test allows you to estimate the effect size and test the null hypothesis that the population mean equals a specific constant,i.e., the test value.\n") +
+	"## " + "Assumptions" + "\n" + "- Continuous dependent variable.\n" + "- The data are a random sample from the population.\n" + "- The dependent variable is normally distributed in the population."
 	id: form
 	property int framework:	Common.Type.Framework.Bayesian
 
@@ -38,7 +40,7 @@ Form
 	{
 		preferredHeight: jaspTheme.smallDefaultVariablesFormHeight
 		AvailableVariablesList { name: "allVariablesList" }
-		AssignedVariablesList { name: "dependent"; title: qsTr("Variables"); allowedColumns: ["scale"]; minNumericLevels: 2 }
+		AssignedVariablesList { name: "dependent"; title: qsTr("Variables"); info: qsTr("In this box the dependent variable is selected.\n") + "- Test value: Test value specified in the null hypothesis." ; allowedColumns: ["scale"]; minNumericLevels: 2 }
 	}
 
 	DoubleField { name: "testValue"; label: qsTr("Test value:"); defaultValue: 0; negativeValues: true }
@@ -50,28 +52,32 @@ Form
 
 		CheckBox
 		{
-			name: "priorAndPosteriorPlot";		label: qsTr("Prior and posterior")
+			name: "priorAndPosteriorPlot";		label: qsTr("Prior and posterior"); info: qsTr("Displays the prior and posterior distribution of the effect size after the data is seen.\n") + "\t" + "- Additional info: Adds the Bayes factor computed with the user-defined prior; adds a probability wheel depicting how likely the data is under the null vs. alternative hypothesis; adds the median and the 95% credible interval of the posterior distribution of the effect size."
 			CheckBox { name: "priorAndPosteriorPlotAdditionalInfo";		label: qsTr("Additional info"); checked: true }
 			CIField  { name: "priorAndPosteriorPlotCiLevel";	label: qsTr("Credible interval") }
 		}
 
 		CheckBox
 		{
 			enabled: student.checked && priors.defaultPriorsChecked
-			name: "bfRobustnessPlot";	label: qsTr("Bayes factor robustness check")
+			name: "bfRobustnessPlot";	label: qsTr("Bayes factor robustness check"); info: qsTr("Displays the Bayes factor accross different values of cauchy prior width. The scale of the Cauchy prior is varied between 0 and 1.5, creating progressively more uninformative priors.\n") +
+			"\t" + "- Additional info: Adds the Bayes factor computed with the user-defined prior; adds a probability wheel depicting how likely the data is under the null vs. alternative hypothesis; adds the median and the 95% credible interval of the posterior distribution of the effect size."
 			CheckBox { name: "bfRobustnessPlotAdditionalInfo";	label: qsTr("Additional info"); checked: true }
 		}
 
 		CheckBox
 		{
 			enabled: student.checked && priors.defaultPriorsChecked
-			name: "bfSequentialPlot";		label: qsTr("Sequential analysis")
+			name: "bfSequentialPlot";		label: qsTr("Sequential analysis"); info: qsTr("Displays the development of the Bayes factor as the data come in using the user-defined prior.\n") +
+			"\t" + "- Robustness check: Adds the results of the sequential analysis using the wide (scale=1) and ultrawide prior (scale=sqrt(2))."
 			CheckBox { name: "bfSequentialPlotRobustness";		label: qsTr("Robustness check") }
 		}
 
 		CheckBox
 		{
-			name: "descriptivesPlot";			label: qsTr("Descriptives")
+			name: "descriptivesPlot";			label: qsTr("Descriptives"); info: qsTr("\n") + "\t" + "- Credible interval: Display central credible intervals. A credible interval shows the probability that the true effect size lies within certain values. The default credible interval is set at 95%.\n"
+			 + "- Bar plots: Displays the sample means as bars and the credible intervals or standard errors as error bars for each measure.\n" + "\t" + "- Credible interval: Displays the central credible intervals. By default, the credible interval is set to 95%. This can be changed into the desired percentage.\n" +
+			"\t" + "- Standard error: By selecting this option, the error bars will represent standard errors of the mean of each condition.\n" + "\t" + "- Fix horizontal axis to 0: Forces the graph to show the default x-axis at y = 0."
 			CIField { name: "descriptivesPlotCiLevel";	label: qsTr("Credible interval") }
 		}
 
@@ -82,7 +88,8 @@ Form
 
 		CheckBox
 		{
-			name: "raincloudPlot"; label: qsTr("Raincloud plots")
+			name: "raincloudPlot"; label: qsTr("Raincloud plots"); info: qsTr("Displays the individual cases (colored dots), box plots, and densities for each group.\n") +
+			"\t" + "- Horizontal display: Changes the orientation of the raincloud plot so that the x-axis represents the dependent variable."
 			CheckBox { name: "raincloudPlotHorizontal"; label: qsTr("Horizontal display") }
 		}
 	}
@@ -93,9 +100,9 @@ Form
 		id:		hypothesis
 		name:	"alternative"
 		title:	qsTr("Alternative Hypothesis")
-		RadioButton { value: "twoSided";		label: qsTr("≠ Test value"); checked: true		}
-		RadioButton { value: "greater";	label: qsTr("> Test value");					}
-		RadioButton { value: "less";		label: qsTr("< Test value");					}
+		RadioButton { value: "twoSided";		label: qsTr("≠ Test value"); info: qsTr("Two-sided alternative hypothesis that the population mean is not equal to the test value. Selected by default."); checked: true		}
+		RadioButton { value: "greater";	label: qsTr("> Test value"); info: qsTr("One-sided alternative hypothesis that the population mean is larger than the test value.")	}
+		RadioButton { value: "less";		label: qsTr("< Test value"); info: qsTr("One sided alternative hypothesis that the population mean is smaller than the test value.")					}
 	}
 
 	BayesFactorType { correlated: hypothesis.value }
@@ -108,29 +115,31 @@ Form
 		RadioButton
 		{
 			id: student
-			value: "student";	label: qsTr("Student"); checked: true }
+			value: "student";	label: qsTr("Student"); info: qsTr("Student's t-test. This option is selected by default.") ; checked: true }
 		RadioButton
 		{
-			value: "wilcoxon";	label: qsTr("Wilcoxon signed-rank"); id: testWilcoxon
+			value: "wilcoxon";	label: qsTr("Wilcoxon signed-rank"); info: qsTr("Non-parametric version of one-sample t-test. Use when data is not normally distributed.\n") +
+			"\t" + "- No.samples: Number of MCMC samples to use"; id: testWilcoxon
 			IntegerField { name: "wilcoxonSamples"; label: qsTr("No. samples"); defaultValue: 1000; min: 100; max: 10000; fieldWidth: 60 }
 		}
 	}
 
 	Group
 	{
-		title: qsTr("Additional Statistics")
+		title: qsTr("Additional Statistics"); info: qsTr("\n") + "- Descriptives: Sample size, sample mean, sample standard deviation, and standard error of the mean for each group."
 		CheckBox { name: "descriptives";	label: qsTr("Descriptives") }
 	}
 
 	RadioButtonGroup
 	{
 		name: "naAction"
 		title: qsTr("Missing Values")
-		RadioButton { value: "perDependent";	label: qsTr("Exclude cases per dependent variable"); checked: true }
-		RadioButton { value: "listwise";				label: qsTr("Exclude cases listwise")							}
+		RadioButton { value: "perDependent";	label: qsTr("Exclude cases per dependent variable"); info: qsTr("In case of multiple t-tests within a single analysis, each test will be conducted using all cases with valid data for the dependent variable for the particular t-test. Sample sizes may therefore vary across the multiple t-tests.; checked: true") }
+		RadioButton { value: "listwise";				label: qsTr("Exclude cases listwise"); info: qsTr(" In case of multiple t-tests within a single analysis, each t-test will be conducted using only cases with valid data for all dependent variables. Sample size is therefore constant across the multiple t-tests.\n") +
+		"## " + "prior" + "\n" + "\t" + "Standardized effect size\n" + "\t" + "\t" + "Default\n" + "\t" + "\t" + "\t" + "- Cauchy: Scale of the Cauchy prior distribution on effect size under the alternative hypothesis; the default is 0.707.\n" +
+ "\t" + "\t" + "Informed\n" + "\t" + "\t" + "\t" + "- Cauchy: Scale and location.\n" + "\t" + "\t" + "\t" + "- Normal: Mean and standard deviation." + "\t" + "\t" + "\t" + "- Student's t: Scale, location and degrees of freedom (df)."							}
 	}
 
 
 	SubjectivePriors { id: priors }
-
 }