compileprofile-spacetests 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# compileprofile-spacetests
+
+A package for evaluating cognitive test results, specifically designed for memory tests.
+
+## Installation
+
+```bash
+npm install compileprofile-spacetests
+```
+
+## Usage
+
+```typescript
+import { evaluateMemoryTest, MemoryTestData, SubjectParameters } from 'compileprofile-spacetests';
+// Evaluate the test results
+const results = evaluateMemoryTest(testData, subjectParams);
+console.log(results);
+```
+
+
+## Development
+
+Basic js distribution
+
+## API
+
+Evaluates memory test results and returns a comprehensive analysis including:
+- Overall accuracy
+- Average reaction time
+- Total correct responses
+- Total number of trials
+- Age-adjusted score (for subjects between 18-65)
+- Gender-specific percentile (when gender is specified)
+
+## License

package/dist/cjs/getters.d.ts

@@ -0,0 +1,2 @@
+declare function getBrowserInformation(data: any[]): any;
+export { getBrowserInformation };

package/dist/cjs/getters.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBrowserInformation = getBrowserInformation;
+function getBrowserInformation(data) {
+    var browserInfo = data.find(function (row) { return row.trial_type === "browser-check"; });
+    if (!browserInfo) {
+        return null;
+    }
+    return {
+        os: browserInfo.os,
+        mobile: browserInfo.mobile,
+        fullscreen: browserInfo.fullscreen,
+        vsync_rate: browserInfo.vsync_rate,
+        webcam: browserInfo.webcam,
+        microphone: browserInfo.microphone,
+        browser: browserInfo.browser,
+        browser_version: browserInfo.browser_version,
+        webaudio: browserInfo.webaudio,
+        width: browserInfo.width,
+        height: browserInfo.height
+    };
+}

package/dist/cjs/gonogo.d.ts

@@ -0,0 +1,3 @@
+declare const gonogo_calculate_results: (data: any) => void;
+declare const gonogo_extract_trials: (data: any) => void;
+declare const gonogo_results: (data: any) => void;

package/dist/cjs/gonogo.js

@@ -0,0 +1,30 @@
+"use strict";
+// gonogo_create_trial_table <- function(txt) {
+//   arr <- fromJSON(txt)
+//   df <- as.data.frame(fromJSON(arr[[1]]))
+//   GONOGO_IMAGE_PATH <- "https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/gonogo/"
+//   df <- filter(df, !is.na(image))
+//   df <- select(df, trial_index, time_elapsed, rt,
+//                response, block_number, image)
+//   df$image <- gsub(GONOGO_IMAGE_PATH, "", df$image)
+//   df$image <- gsub(".png", "", df$image)
+//   df <- df %>%
+//     mutate(
+//       should_go = case_when(
+//         block_number == 1 & grepl("astronaut_trans_1", image) ~ TRUE,
+//         block_number == 2 & grepl("alien_trans_1", image) ~ TRUE,
+//         block_number == 3 & grepl("rocket_trans_1", image) ~ TRUE,
+//         block_number == 4 & !grepl("rocket_trans_1", image) ~ TRUE,
+//         TRUE ~ FALSE),
+//       did_go = !is.na(response),
+//       correct = should_go == did_go
+//     )
+//   return(df)
+// }
+var gonogo_calculate_results = function (data) {
+};
+var gonogo_extract_trials = function (data) {
+    // GONOGO_IMAGE_PATH <- "https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/gonogo/"
+};
+var gonogo_results = function (data) {
+};

package/dist/cjs/index.d.ts

@@ -0,0 +1,5 @@
+import { NBackResults } from './nback';
+import { SpatialResults } from './spatial-cognition';
+declare const NbackResults: (obj: any[]) => NBackResults;
+declare const SpatialCognitionResults: (obj: any[]) => SpatialResults;
+export { NbackResults, SpatialCognitionResults };

package/dist/cjs/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpatialCognitionResults = exports.NbackResults = void 0;
+var nback_1 = require("./nback");
+var spatial_cognition_1 = require("./spatial-cognition");
+var NbackResults = function (obj) {
+    return (0, nback_1.nback_calculate_results)(obj);
+};
+exports.NbackResults = NbackResults;
+var SpatialCognitionResults = function (obj) {
+    return (0, spatial_cognition_1.spatial_calculate_results)(obj);
+};
+exports.SpatialCognitionResults = SpatialCognitionResults;

package/dist/cjs/nback.d.ts

@@ -0,0 +1,15 @@
+declare const nback_calculate_results: (obj: any[]) => NBackResults;
+declare const nback_extract_trials: (obj: any[]) => any[];
+interface NbackTrialResults {
+    n: number;
+    avg_rt: number;
+    avg_acc: number;
+}
+interface NBackResults {
+    total_trials: NbackTrialResults;
+    target_trials: NbackTrialResults;
+    non_target_trials: NbackTrialResults;
+    performance: number;
+}
+declare const nback_results: (trials: any[]) => NBackResults;
+export { nback_extract_trials, nback_results, nback_calculate_results, NBackResults };

package/dist/cjs/nback.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nback_calculate_results = exports.nback_results = exports.nback_extract_trials = void 0;
+// from the passed json extract those objects that have field is_target
+var nback_calculate_results = function (obj) {
+    var trials = nback_extract_trials(obj);
+    return nback_results(trials);
+};
+exports.nback_calculate_results = nback_calculate_results;
+var nback_extract_trials = function (obj) {
+    var trials = obj.filter(function (o) { return 'is_target' in o; });
+    return trials;
+};
+exports.nback_extract_trials = nback_extract_trials;
+var nback_results = function (trials) {
+    var target_trials = trials.filter(function (o) { return o.is_target; });
+    var non_target_trials = trials.filter(function (o) { return !o.is_target; });
+    var results = {
+        total_trials: {
+            n: trials.length,
+            avg_rt: trials.reduce(function (a, b) { return a + b.rt; }, 0) / trials.length,
+            avg_acc: trials.reduce(function (a, b) { return a + b.correct; }, 0) / trials.length,
+        },
+        target_trials: {
+            n: target_trials.length,
+            avg_rt: target_trials.reduce(function (a, b) { return a + b.rt; }, 0) / target_trials.length,
+            avg_acc: target_trials.reduce(function (a, b) { return a + b.correct; }, 0) / target_trials.length,
+        },
+        non_target_trials: {
+            n: non_target_trials.length,
+            avg_rt: non_target_trials.reduce(function (a, b) { return a + b.rt; }, 0) / non_target_trials.length,
+            avg_acc: non_target_trials.reduce(function (a, b) { return a + b.correct; }, 0) / non_target_trials.length,
+        },
+        performance: NaN
+    };
+    results.performance = results.total_trials.avg_acc;
+    console.log(results);
+    return results;
+};
+exports.nback_results = nback_results;

package/dist/cjs/spatial-cognition.d.ts

@@ -0,0 +1,11 @@
+interface SpatialResults {
+    n: number;
+    avg_rt: number;
+    avg_acc: number;
+    performance: number;
+}
+declare const spatial_calculate_results: (obj: any[]) => SpatialResults;
+declare const spatial_extract_trials: (obj: any[]) => any[];
+declare const spatial_results: (obj: any[]) => SpatialResults;
+declare const spatial_extract_image_info: (obj: any[]) => any[];
+export { spatial_extract_image_info, spatial_extract_trials, spatial_results, spatial_calculate_results, SpatialResults };

package/dist/cjs/spatial-cognition.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spatial_calculate_results = exports.spatial_results = exports.spatial_extract_trials = exports.spatial_extract_image_info = void 0;
+var spatial_calculate_results = function (obj) {
+    var trials = spatial_extract_trials(obj);
+    return spatial_results(trials);
+};
+exports.spatial_calculate_results = spatial_calculate_results;
+var spatial_extract_trials = function (obj) {
+    var trials = obj.filter(function (o) { return 'stimulus' in o &&
+        o.stimulus.startsWith("<img src="); });
+    trials = spatial_extract_image_info(trials);
+    return trials;
+};
+exports.spatial_extract_trials = spatial_extract_trials;
+var spatial_results = function (obj) {
+    var results = {
+        n: obj.length,
+        avg_rt: obj.reduce(function (a, b) { return a + b.rt; }, 0) / obj.length,
+        avg_acc: obj.reduce(function (a, b) { return a + b.correct; }, 0) / obj.length,
+        performance: NaN
+    };
+    var best_score = 1000;
+    var worst_score = 10000;
+    // results.avg_acc to the power of 5
+    var performance = results.avg_rt / (Math.pow(results.avg_acc, 5) + 0.001);
+    if (performance < best_score) {
+        performance = best_score;
+    }
+    if (performance > worst_score) {
+        performance = worst_score;
+    }
+    // convert to 0-100 where 100 is the best (200)
+    results.performance = (1 - ((performance - best_score) / (worst_score - best_score))) * 100;
+    return results;
+};
+exports.spatial_results = spatial_results;
+var spatial_extract_image_info = function (obj) {
+    // from the following field, extract the final image name (map_left_1_90.png), and rotation from the class attribute (rotate_0)
+    //  "stimulus": "<img src=\"https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/spatialcognition/map_left_1_90.png\" class=\"max-w-none rotate_0\" width=\"512\" height=\"512\" alt=\"Mapa\">",
+    obj.forEach(function (o) {
+        var _a, _b, _c, _d, _e;
+        // the image name is map_left_1_90.png
+        o.image = (_a = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _a === void 0 ? void 0 : _a[0];
+        o.direction = (_b = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _b === void 0 ? void 0 : _b[1];
+        o.distance = (_c = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _c === void 0 ? void 0 : _c[2];
+        o.angle = (_d = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _d === void 0 ? void 0 : _d[3];
+        o.rotation = (_e = o.stimulus.match(/rotate_(\d+)/)) === null || _e === void 0 ? void 0 : _e[1];
+        o.response = o.response === 1 ? "right" : "left";
+        o.correct = o.response === o.direction;
+    });
+    return obj;
+};
+exports.spatial_extract_image_info = spatial_extract_image_info;

package/dist/esm/getters.d.ts

@@ -0,0 +1,2 @@
+declare function getBrowserInformation(data: any[]): any;
+export { getBrowserInformation };

package/dist/esm/getters.js

@@ -0,0 +1,20 @@
+function getBrowserInformation(data) {
+    var browserInfo = data.find(function (row) { return row.trial_type === "browser-check"; });
+    if (!browserInfo) {
+        return null;
+    }
+    return {
+        os: browserInfo.os,
+        mobile: browserInfo.mobile,
+        fullscreen: browserInfo.fullscreen,
+        vsync_rate: browserInfo.vsync_rate,
+        webcam: browserInfo.webcam,
+        microphone: browserInfo.microphone,
+        browser: browserInfo.browser,
+        browser_version: browserInfo.browser_version,
+        webaudio: browserInfo.webaudio,
+        width: browserInfo.width,
+        height: browserInfo.height
+    };
+}
+export { getBrowserInformation };

package/dist/esm/gonogo.d.ts

@@ -0,0 +1,3 @@
+declare const gonogo_calculate_results: (data: any) => void;
+declare const gonogo_extract_trials: (data: any) => void;
+declare const gonogo_results: (data: any) => void;

package/dist/esm/gonogo.js

@@ -0,0 +1,30 @@
+"use strict";
+// gonogo_create_trial_table <- function(txt) {
+//   arr <- fromJSON(txt)
+//   df <- as.data.frame(fromJSON(arr[[1]]))
+//   GONOGO_IMAGE_PATH <- "https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/gonogo/"
+//   df <- filter(df, !is.na(image))
+//   df <- select(df, trial_index, time_elapsed, rt,
+//                response, block_number, image)
+//   df$image <- gsub(GONOGO_IMAGE_PATH, "", df$image)
+//   df$image <- gsub(".png", "", df$image)
+//   df <- df %>%
+//     mutate(
+//       should_go = case_when(
+//         block_number == 1 & grepl("astronaut_trans_1", image) ~ TRUE,
+//         block_number == 2 & grepl("alien_trans_1", image) ~ TRUE,
+//         block_number == 3 & grepl("rocket_trans_1", image) ~ TRUE,
+//         block_number == 4 & !grepl("rocket_trans_1", image) ~ TRUE,
+//         TRUE ~ FALSE),
+//       did_go = !is.na(response),
+//       correct = should_go == did_go
+//     )
+//   return(df)
+// }
+var gonogo_calculate_results = function (data) {
+};
+var gonogo_extract_trials = function (data) {
+    // GONOGO_IMAGE_PATH <- "https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/gonogo/"
+};
+var gonogo_results = function (data) {
+};

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import { NBackResults } from './nback';
+import { SpatialResults } from './spatial-cognition';
+declare const NbackResults: (obj: any[]) => NBackResults;
+declare const SpatialCognitionResults: (obj: any[]) => SpatialResults;
+export { NbackResults, SpatialCognitionResults };

package/dist/esm/index.js

@@ -0,0 +1,9 @@
+import { nback_calculate_results } from './nback';
+import { spatial_calculate_results } from './spatial-cognition';
+var NbackResults = function (obj) {
+    return nback_calculate_results(obj);
+};
+var SpatialCognitionResults = function (obj) {
+    return spatial_calculate_results(obj);
+};
+export { NbackResults, SpatialCognitionResults };

package/dist/esm/nback.d.ts

@@ -0,0 +1,15 @@
+declare const nback_calculate_results: (obj: any[]) => NBackResults;
+declare const nback_extract_trials: (obj: any[]) => any[];
+interface NbackTrialResults {
+    n: number;
+    avg_rt: number;
+    avg_acc: number;
+}
+interface NBackResults {
+    total_trials: NbackTrialResults;
+    target_trials: NbackTrialResults;
+    non_target_trials: NbackTrialResults;
+    performance: number;
+}
+declare const nback_results: (trials: any[]) => NBackResults;
+export { nback_extract_trials, nback_results, nback_calculate_results, NBackResults };

package/dist/esm/nback.js

@@ -0,0 +1,35 @@
+// from the passed json extract those objects that have field is_target
+var nback_calculate_results = function (obj) {
+    var trials = nback_extract_trials(obj);
+    return nback_results(trials);
+};
+var nback_extract_trials = function (obj) {
+    var trials = obj.filter(function (o) { return 'is_target' in o; });
+    return trials;
+};
+var nback_results = function (trials) {
+    var target_trials = trials.filter(function (o) { return o.is_target; });
+    var non_target_trials = trials.filter(function (o) { return !o.is_target; });
+    var results = {
+        total_trials: {
+            n: trials.length,
+            avg_rt: trials.reduce(function (a, b) { return a + b.rt; }, 0) / trials.length,
+            avg_acc: trials.reduce(function (a, b) { return a + b.correct; }, 0) / trials.length,
+        },
+        target_trials: {
+            n: target_trials.length,
+            avg_rt: target_trials.reduce(function (a, b) { return a + b.rt; }, 0) / target_trials.length,
+            avg_acc: target_trials.reduce(function (a, b) { return a + b.correct; }, 0) / target_trials.length,
+        },
+        non_target_trials: {
+            n: non_target_trials.length,
+            avg_rt: non_target_trials.reduce(function (a, b) { return a + b.rt; }, 0) / non_target_trials.length,
+            avg_acc: non_target_trials.reduce(function (a, b) { return a + b.correct; }, 0) / non_target_trials.length,
+        },
+        performance: NaN
+    };
+    results.performance = results.total_trials.avg_acc;
+    console.log(results);
+    return results;
+};
+export { nback_extract_trials, nback_results, nback_calculate_results };

package/dist/esm/spatial-cognition.d.ts

@@ -0,0 +1,11 @@
+interface SpatialResults {
+    n: number;
+    avg_rt: number;
+    avg_acc: number;
+    performance: number;
+}
+declare const spatial_calculate_results: (obj: any[]) => SpatialResults;
+declare const spatial_extract_trials: (obj: any[]) => any[];
+declare const spatial_results: (obj: any[]) => SpatialResults;
+declare const spatial_extract_image_info: (obj: any[]) => any[];
+export { spatial_extract_image_info, spatial_extract_trials, spatial_results, spatial_calculate_results, SpatialResults };

package/dist/esm/spatial-cognition.js

@@ -0,0 +1,48 @@
+var spatial_calculate_results = function (obj) {
+    var trials = spatial_extract_trials(obj);
+    return spatial_results(trials);
+};
+var spatial_extract_trials = function (obj) {
+    var trials = obj.filter(function (o) { return 'stimulus' in o &&
+        o.stimulus.startsWith("<img src="); });
+    trials = spatial_extract_image_info(trials);
+    return trials;
+};
+var spatial_results = function (obj) {
+    var results = {
+        n: obj.length,
+        avg_rt: obj.reduce(function (a, b) { return a + b.rt; }, 0) / obj.length,
+        avg_acc: obj.reduce(function (a, b) { return a + b.correct; }, 0) / obj.length,
+        performance: NaN
+    };
+    var best_score = 1000;
+    var worst_score = 10000;
+    // results.avg_acc to the power of 5
+    var performance = results.avg_rt / (Math.pow(results.avg_acc, 5) + 0.001);
+    if (performance < best_score) {
+        performance = best_score;
+    }
+    if (performance > worst_score) {
+        performance = worst_score;
+    }
+    // convert to 0-100 where 100 is the best (200)
+    results.performance = (1 - ((performance - best_score) / (worst_score - best_score))) * 100;
+    return results;
+};
+var spatial_extract_image_info = function (obj) {
+    // from the following field, extract the final image name (map_left_1_90.png), and rotation from the class attribute (rotate_0)
+    //  "stimulus": "<img src=\"https://unyavwofnmwihnpvkjji.supabase.co/storage/v1/object/public/test-stimuli/spatialcognition/map_left_1_90.png\" class=\"max-w-none rotate_0\" width=\"512\" height=\"512\" alt=\"Mapa\">",
+    obj.forEach(function (o) {
+        var _a, _b, _c, _d, _e;
+        // the image name is map_left_1_90.png
+        o.image = (_a = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _a === void 0 ? void 0 : _a[0];
+        o.direction = (_b = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _b === void 0 ? void 0 : _b[1];
+        o.distance = (_c = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _c === void 0 ? void 0 : _c[2];
+        o.angle = (_d = o.stimulus.match(/map_(left|right)_(\d+)_(\d+)\.png/)) === null || _d === void 0 ? void 0 : _d[3];
+        o.rotation = (_e = o.stimulus.match(/rotate_(\d+)/)) === null || _e === void 0 ? void 0 : _e[1];
+        o.response = o.response === 1 ? "right" : "left";
+        o.correct = o.response === o.direction;
+    });
+    return obj;
+};
+export { spatial_extract_image_info, spatial_extract_trials, spatial_results, spatial_calculate_results };