panoptes-subject-set-util

A command line utility to manage Zooniverse (Panoptes) subject sets.

Installation

npm install panoptes-subject-set-util --global does the trick. The --global lets you run ssutil on the command line.

Description

The Subject Set Utility implements a CLI to 1) list subjects sets in a project, 2) create linked lists of subjects for sequential pagination, and 3) activate/deactivate subject sets (currently only supported by Old Weather)

Examples

Listing Subject Sets

$ # list subject sets for project 195
$ ssutil list -p 195
┌──────────┬──────────┬──────────┬────────────────────┬────────────────────┐
│ ID       │ Active   │ Count    │ Short Name         │ Display Name       │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 2369     │ false    │ 11       │ some name          │ Ammen 1944         │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 2370     │ false    │ 3        │ some name          │ Ammen 1960         │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 2371     │ true     │ 10       │ Bear               │ Bear (Random)      │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 3903     │ n/a      │ 100      │ n/a                │ JS Textbook (dupl… │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 3783     │ true     │ 100      │ jsBook             │ JS Textbook (Sequ… │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 3776     │ true     │ 380      │ The Other Bear     │ Test Subject Set   │
├──────────┼──────────┼──────────┼────────────────────┼────────────────────┤
│ 3782     │ true     │ 5        │ the numbers        │ The Numbers        │
└──────────┴──────────┴──────────┴────────────────────┴────────────────────┘

Creating Linked Subject Lists

$ ssutil link-pages -p 195 -s 3782 --cache-size 3 --dryrun

This generates a linked list by adding nextSubjectIds and prevSubjectIds to each subject's metadata. The --cache-size option determines how many next/prev subjects are stored, provided they exist. For example, the first and last subjects will have empty prevSubjectIds and nextSubjectIds arrays, respectively. The --dryrun option dumps an array of modified subjects and will not commit them to the server.

The code below shows the first two subjects generated by the link-pages command:

[{
        "id": "47676",
        "metadata": {
            "file": "01.jpg",
            "pageNumber": "1",
            "description": "the number one",
            "nextSubjectId": "47679",
            "prevSubjectId": null,
            "prevSubjectIds": [],
            "nextSubjectIds": ["47679", "47677", "47675"]
        },
        "locations": [{
            "image/jpeg": "https://panoptes-uploads.zooniverse.org/staging/subject_location/62774c6e-0f42-41e6-91e6-dc4b3cea24d8.jpeg"
        }],
        "zooniverse_id": null,
        "created_at": "2016-07-15T18:45:48.154Z",
        "updated_at": "2016-07-22T15:32:47.469Z",
        "href": "/subjects/47676",
        "links": {
            "project": "195"
        }
    }, {
        "id": "47679",
        "metadata": {
            "file": "02.jpg",
            "pageNumber": "2",
            "description": "the number two",
            "nextSubjectId": "47677",
            "prevSubjectId": "47676",
            "prevSubjectIds": ["47676"],
            "nextSubjectIds": ["47677", "47675", "47678"]
        },
        "locations": [{
            "image/jpeg": "https://panoptes-uploads.zooniverse.org/staging/subject_location/fa8f1237-7d78-4c72-b3a1-9d0a5c45b2e4.jpeg"
        }],
        "zooniverse_id": null,
        "created_at": "2016-07-15T18:45:49.807Z",
        "updated_at": "2016-07-22T15:32:49.067Z",
        "href": "/subjects/47679",
        "links": {
            "project": "195"
        }
    }]

Requirements

Zooniverse acount,
Permissions (either as an owner or collaborator) to a Zooniverse project, and
Subject set linked to the project

Package detail