README

FiveThirtyEight Food Frequency Questionnaire

FiveThirtyEight reader responses to a food frequency questionnaire (FFQ).

Usage

var dataset = require( '@stdlib/dist-datasets-fivethirtyeight-ffq' ).FIVETHIRTYEIGHT_FFQ;

dataset()

Returns FiveThirtyEight reader responses to a food frequency questionnaire (FFQ).

var data = dataset();
// returns [ {...}, ... ]

Notes

The administered food frequency questionnaire (FFQ) was the proprietary Block FFQ.
This package contains distributable files for use in browser environments or as shared ("vendored") libraries in server environments. Each distributable file is a standalone UMD bundle which, if no recognized module system is present, will expose bundle contents to the global scope.
Each minified bundle has a corresponding gzip-compressed bundle. The gzip compression level for each compressed bundle is 9, which is the highest (and most optimal) compression level. Deciding between uncompressed and compressed bundles depends on the application and whether compression is handled elsewhere in the application stack (e.g., nginx, CDN, et cetera).
While you are strongly encouraged to vendor bundles and host with a CDN/provider which can provide availability guarantees, especially for production applications, bundles are available via unpkg for quick demos, proof-of-concepts, and instructional material. For example,
```
<script type="text/javascript" src="https://unpkg.com/@stdlib/dist-datasets-fivethirtyeight-ffq"></script>
```
Please be mindful that unpkg is a free, best-effort service relying on donated infrastructure which does not provide any availability guarantees. Under no circumstances should you abuse or misuse the service. You have been warned.
If you intend on embedding a standalone bundle within another bundle, you may need to rename require calls within the standalone bundle before bundling in order to maintain scoped module resolution. For example, if you plan on using browserify to generate a bundle containing embedded bundles, browserify plugins exist to "de-require" those bundles prior to bundling.
The bundles in this package expose the following stdlib packages:
- @stdlib/datasets/fivethirtyeight-ffq

Examples

var bifurcateBy = require( '@stdlib/utils/bifurcate-by' );
var inmap = require( '@stdlib/utils/inmap' );
var ttest2 = require( '@stdlib/stats/ttest2' );
var dataset = require( '@stdlib/dist-datasets-fivethirtyeight-ffq' ).FIVETHIRTYEIGHT_FFQ;

function predicate( v ) {
    return ( v.diabetes === 1 );
}

function createAccessor( field ) {
    return accessor;

    function accessor( v ) {
        return v[ field ];
    }
}

// Retrieve the data:
var data = dataset();

// Split the data into two groups based on whether a respondent has diabetes:
var groups = bifurcateBy( data, predicate );

// For each group, extract the frequency of green salad consumption:
var mapFcn = createAccessor( 'greensaladfreq' );
var g1 = inmap( groups[ 0 ].slice(), mapFcn );
var g2 = inmap( groups[ 1 ].slice(), mapFcn );

// Perform a two-sample two-sided Student's t-test to determine if green salad consumption is different between the two groups:
var results = ttest2( g1, g2 );
console.log( results.print() );

To include the bundle in a webpage,

<script type="text/javascript" src="/path/to/@stdlib/dist-datasets-fivethirtyeight-ffq/build/bundle.min.js"></script>

If no recognized module system is present, access bundle contents via the global scope.

<script type="text/javascript">
    // If no recognized module system present, exposed to global scope:
    var dataset = stdlib_datasets_fivethirtyeight_ffq.FIVETHIRTYEIGHT_FFQ;
    console.log( dataset() );
</script>