npmpackage.info

Gathering detailed insights and metrics for @stdlib/stats-ttest2

@stdlib/stats-ttest2 - 0.2.2 | npmpackage.info

@stdlib/stats-ttest2

Two-sample Student's t-Test.

0.2.2

Apache-2.0

JavaScript

63.58 kB

4.5

Installations

npm install @stdlib/stats-ttest2

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=0.10.0

Node Version

16.20.2

NPM Version

8.19.4 Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

stdlib-js

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

Apache-2.0 License

4 Stars

67 Commits

3 Watchers

5 Branches

14 Contributors

Updated on Jul 01, 2025

Sponsor this package

https://opencollective.com/stdlib

Maintainers

View All 14 Contributors

Package Meta Information

Latest Version

0.2.2

Package Id

@stdlib/stats-ttest2@0.2.2

Unpacked Size

63.58 kB

Size

15.85 kB

File Count

NPM Version

8.19.4

Node Version

16.20.2

Published on

Jul 29, 2024

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

About stdlib...

We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.

The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.

When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.

To join us in bringing numerical computing to the web, get started by checking us out on GitHub, and please consider financially supporting stdlib. We greatly appreciate your continued support!

Student's t-Test

Two-sample Student's t-Test.

Installation

1npm install @stdlib/stats-ttest2

Usage

1var ttest2 = require( '@stdlib/stats-ttest2' );

ttest2( x, y[, opts] )

By default, the function performs a two-sample t-test for the null hypothesis that the data in arrays or typed arrays x and y is independently drawn from normal distributions with equal means.

1// Student's sleep data:
2var x = [ 0.7, -1.6, -0.2, -1.2, -0.1, 3.4, 3.7, 0.8, 0.0, 2.0 ];
3var y = [ 1.9, 0.8, 1.1, 0.1, -0.1, 4.4, 5.5, 1.6, 4.6, 3.4 ];
4
5var out = ttest2( x, y );
6/* e.g., returns
7    {
8        'rejected': false,
9        'pValue': ~0.079,
10        'statistic': ~-1.861,
11        'ci': [ ~-3.365, ~0.205 ],
12        // ...
13    }
14*/

The returned object comes with a .print() method which when invoked will print a formatted output of the results of the hypothesis test. print accepts a digits option that controls the number of decimal digits displayed for the outputs and a decision option, which when set to false will hide the test decision.

1console.log( out.print() );
2/* e.g., =>
3    Welch two-sample t-test
4
5    Alternative hypothesis: True difference in means is not equal to 0
6
7        pValue: 0.0794
8        statistic: -1.8608
9        95% confidence interval: [-3.3655,0.2055]
10
11    Test Decision: Fail to reject null in favor of alternative at 5% significance level
12*/

The function accepts the following options:

alpha: number in the interval [0,1] giving the significance level of the hypothesis test. Default: 0.05.
alternative: Either two-sided, less or greater. Indicates whether the alternative hypothesis is that x has a larger mean than y (greater), x has a smaller mean than y (less) or the means are the same (two-sided). Default: two-sided.
difference: number denoting the difference in means under the null hypothesis. Default: 0.
variance: string indicating if the test should be conducted under the assumption that the unknown variances of the normal distributions are equal or unequal. Default: unequal.

By default, the hypothesis test is carried out at a significance level of 0.05. To choose a different significance level, set the alpha option.

1var x = [ 0.7, -1.6, -0.2, -1.2, -0.1, 3.4, 3.7, 0.8, 0.0, 2.0 ];
2var y = [ 1.9, 0.8, 1.1, 0.1, -0.1, 4.4, 5.5, 1.6, 4.6, 3.4 ];
3
4var out = ttest2( x, y, {
5    'alpha': 0.1
6});
7var table = out.print();
8/* e.g., returns
9    Welch two-sample t-test
10
11    Alternative hypothesis: True difference in means is not equal to 0
12
13        pValue: 0.0794
14        statistic: -1.8608
15        90% confidence interval: [-3.0534,-0.1066]
16
17    Test Decision: Reject null in favor of alternative at 10% significance level
18*/

By default, a two-sided test is performed. To perform either of the one-sided tests, set the alternative option to less or greater.

1// Student's sleep data:
2var x = [ 0.7, -1.6, -0.2, -1.2, -0.1, 3.4, 3.7, 0.8, 0.0, 2.0 ];
3var y = [ 1.9, 0.8, 1.1, 0.1, -0.1, 4.4, 5.5, 1.6, 4.6, 3.4 ];
4
5var out = ttest2( x, y, {
6    'alternative': 'less'
7});
8var table = out.print();
9/* e.g., returns
10    Welch two-sample t-test
11
12    Alternative hypothesis: True difference in means is less than 0
13
14        pValue: 0.0397
15        statistic: -1.8608
16        df: 17.7765
17        95% confidence interval: [-Infinity,-0.1066]
18
19    Test Decision: Reject null in favor of alternative at 5% significance level
20*/
21
22out = ttest2( x, y, {
23    'alternative': 'greater'
24});
25table = out.print();
26/* e.g., returns
27    Welch two-sample t-test
28
29    Alternative hypothesis: True difference in means is greater than 0
30
31        pValue: 0.9603
32        statistic: -1.8608
33        df: 17.7765
34        95% confidence interval: [-3.0534,Infinity]
35
36    Test Decision: Fail to reject null in favor of alternative at 5% significance level
37*/

As a default choice, the ttest2 function carries out the Welch test (using the Satterthwaite approximation for the degrees of freedom), which does not have the requirement that the variances of the underlying distributions are equal. If the equal variances assumption seems warranted, set the variance option to equal.

1var x = [ 2, 3, 1, 4 ];
2var y = [ 1, 2, 3, 1, 2, 5, 3, 4 ];
3
4var out = ttest2( x, y, {
5    'variance': 'equal'
6});
7var table = out.print();
8/* e.g., returns
9    Two-sample t-test
10
11    Alternative hypothesis: True difference in means is not equal to 0
12
13        pValue: 0.8848
14        statistic: -0.1486
15        df: 10
16        95% confidence interval: [-1.9996,1.7496]
17
18    Test Decision: Fail to reject null in favor of alternative at 5% significance level
19*/

To test whether the difference in the population means is equal to some other value than 0, set the difference option.

1var normal = require( '@stdlib/random-base-normal' ).factory;
2
3var rnorm = normal({
4    'seed': 372
5});
6
7var x = [];
8var i;
9for ( i = 0; i < x.length; i++ ) {
10    x.push( rnorm( 2.0, 3.0 ) );
11}
12
13var y = [];
14for ( i = 0; i < x.length; i++ ) {
15    y.push( rnorm( 1.0, 3.0 ) );
16}
17
18var out = ttest2( x, y, {
19    'difference': 1.0,
20    'variance': 'equal'
21});
22/* e.g., returns
23    {
24        'rejected': false,
25        'pValue': ~0.642,
26        'statistic': ~-0.466,
27        'ci': [ ~-0.0455, ~1.646 ],
28        // ...
29    }
30*/
31
32var table = out.print();
33/* e.g., returns
34    Two-sample t-test
35
36    Alternative hypothesis: True difference in means is not equal to 1
37
38        pValue: 0.6419
39        statistic: -0.4657
40        df: 198
41        95% confidence interval: [-0.0455,1.646]
42
43    Test Decision: Fail to reject null in favor of alternative at 5% significance level
44*/

Examples

1var incrspace = require( '@stdlib/array-base-incrspace' );
2var ttest2 = require( '@stdlib/stats-ttest2' );
3
4var a = incrspace( 1, 11, 1 );
5var b = incrspace( 7, 21, 1 );
6
7var out = ttest2( a, b );
8var table = out.print();
9/* e.g., returns
10    Welch two-sample t-test
11
12    Alternative hypothesis: True difference in means is not equal to 0
13
14        pValue: 0
15        statistic: -5.4349
16        95% confidence interval: [-11.0528,-4.9472]
17
18    Test Decision: Reject null in favor of alternative at 5% significance level
19*/

Notice

This package is part of stdlib, a standard library for JavaScript and Node.js, with an emphasis on numerical and scientific computing. The library provides a collection of robust, high performance libraries for mathematics, statistics, streams, utilities, and more.

For more information on the project, filing bug reports and feature requests, and guidance on how to develop stdlib, see the main project repository.

Community

License

See LICENSE.

Copyright

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

9

Security-Policy

Determines if the project has published a security policy.

3

Maintained

Determines if the project is "actively maintained".

3

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 3

Details

Warn: third-party GitHubAction not pinned by hash: .github/workflows/productionize.yml:85: update your workflow using https://app.stepsecurity.io/secureworkflow/stdlib-js/stats-ttest2/productionize.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/productionize.yml:275: update your workflow using https://app.stepsecurity.io/secureworkflow/stdlib-js/stats-ttest2/productionize.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/productionize.yml:449: update your workflow using https://app.stepsecurity.io/secureworkflow/stdlib-js/stats-ttest2/productionize.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/productionize.yml:457: update your workflow using https://app.stepsecurity.io/secureworkflow/stdlib-js/stats-ttest2/productionize.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/productionize.yml:623: update your workflow using https://app.stepsecurity.io/secureworkflow/stdlib-js/stats-ttest2/productionize.yml/main?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/benchmark.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/benchmark.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/benchmark.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/examples.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/examples.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/examples.yml:58
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:157
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:157
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:157
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:165
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:269
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:269
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:269
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:436
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:436
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:436
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:617
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:617
Warn: npmCommand not pinned by hash: .github/workflows/productionize.yml:617
Warn: npmCommand not pinned by hash: .github/workflows/test.yml:76
Warn: npmCommand not pinned by hash: .github/workflows/test.yml:76
Warn: npmCommand not pinned by hash: .github/workflows/test.yml:76
Warn: npmCommand not pinned by hash: .github/workflows/test.yml:83
Warn: npmCommand not pinned by hash: .github/workflows/test_bundles.yml:72
Warn: npmCommand not pinned by hash: .github/workflows/test_coverage.yml:67
Warn: npmCommand not pinned by hash: .github/workflows/test_coverage.yml:67
Warn: npmCommand not pinned by hash: .github/workflows/test_coverage.yml:67
Warn: npmCommand not pinned by hash: .github/workflows/test_coverage.yml:74
Warn: npmCommand not pinned by hash: .github/workflows/test_install.yml:75
Warn: npmCommand not pinned by hash: .github/workflows/test_install.yml:75
Warn: npmCommand not pinned by hash: .github/workflows/test_install.yml:75
Warn: npmCommand not pinned by hash: .github/workflows/test_published_package.yml:93
Info: 33 out of 33 GitHub-owned GitHubAction dependencies pinned
Info: 19 out of 24 third-party GitHubAction dependencies pinned
Info: 0 out of 32 npmCommand dependencies pinned

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

SAST

Determines if the project uses static code analysis.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

Score

4.5

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

@stdlib/stats-ttest2

Installations

Developer Guide

Yes

CommonJS

>=0.10.0

16.20.2

8.19.4

Pull Requests

0

0

0

Issues

0

0

0

Releases

Unable to fetch releases

Languages

Developer

Download Statistics

GitHub Statistics

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Student's t-Test

Installation

Usage

ttest2( x, y[, opts] )

Examples

See Also

Notice

Community

License

Copyright

10

10

10

10

9

3

3

0

0

0

0

0

0

4.5

/10