npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

chronist

v1.0.6

Published

Long-term analysis of emotion, sentiment, and aging using photos and text.

Downloads

3

Readme

Chronist

Long-term analysis of emotion, sentiment, and aging using photos and text.

Chronist is a multifaceted project consisting of:

  • A command-line tool for gathering chronological sentiment analysis of text from iMessages, Facebook Messenger, Day One, and 750 Words
  • A command-line tool for gathering chronological emotion, age, expression, and ethnicity data from photos
  • Python scripts for cleaning and resampling the data generated from these tools for analysis
  • Python scripts for generating visualizations (using matplotlib) of the resulting time-series data
  • An anonymous dataset contributed by a few very generous friends who have agreed to donate their real data

The goal of this project is to quantitatively monitor the emotional and physical changes of an individual over periods of time. My thesis is that if you can accurately show emotional or physical change over time, you can objectively pinpoint how an environmental change such as a career change, moving to a new city, starting or ending a relationship, or starting a new habit like going to the gym affected your physical and emotional health. This can lead to important insights on an individual level and for a population as a whole.

If you are interested in hearing more about this project, contributing your data, or collaborating, contact me at [email protected].

Chronist's command-line tools were written in Javascript/ES6 for Node.js and its data processing scripts were written in Python.

Setup

First, make sure you have Node.js >= 6 and Python 2 or 3 installed.

Then run npm install -g chronist.

Commandline Tool

Run chronist to get started. This will show you the available subcommands.

Gathering Data

Lifeslice

This is an alias of photos which uses the default Lifeslice photo directory (/Users/<USERNAME>/Library/Application Support/LifeSlice/webcam) as its input directory and uses the filenames to detect the dates of the photos. The results will be saved as a CSV on your Desktop by default.

chronist lifeslice

Photos

Run emotion and demographic analysis on a directory of photos. The results will be saved as a CSV on your Desktop by default.

chronist photos ~/Desktop/photos

Facebook

First you'll need to download your Facebook data, then you can run the sentiment analysis on your Facebook messages - make sure to specify your first and last name as they appear on Facebook with -n. The results will be saved as a CSV on your Desktop by default.

chronist facebook -i ~/Desktop/messages.htm -n “Chris Roth”

iMessage

Run a sentiment analysis on the currently logged-in OS X user. The results will be saved as a CSV on your Desktop by default.

chronist imessage

750 Words

First download your 750 Words entries, then run the sentiment analysis on your entries. The results will be saved as a CSV on your Desktop by default.

chronist 750words -i ~/Desktop/750words

Day One

First export your Day One journal entries, then run the sentiment analysis on the JSON export. The results will be saved as a CSV on your Desktop by default.

chronist dayone -i ~/Desktop/journal.json

Working With Data

Run pip install -r requirements.txt to install the Python dependencies. If you do not have pip, you'll need to install it first.

All of the contributed data is stored in /data as CSVs. It is first organized by participant, eg /data/a is participant a's data. Some participants have different datasets available than others, and each file will likely have data from different date ranges. The analysis will be aware of these caveats.

The scripts to run analyses are in /analysis. You can run them with python analysis/comparative.py but using Rodeo is ideal.