This repository contains code for two publications. One relates to demographic embeddings and the other is about personalizing embeddings and language models for specific users.

Note: We were not able to share data directly due to licensing issues. However, the data we downloaded is available here and we have scripts to perform the extraction the same way as described in our paper. This repository contains generated JSON files containing fake data that the scripts can be tested on in the 'data' folder. These files contain fake authors with single letter names in [a-z].

More details of experiments run with this code can be found in our papers on demographic and personalized embeddings.

If you use this code for demographic embeddings please cite:

@InProceedings{emnlp20compositional,
    title   = {Compositional Demographic Word Embeddings},
    author  = {Charles Welch and Jonathan K. Kummerfeld and Ver{\'o}nica P{\'e}rez-Rosas and Rada Mihalcea},
    booktitle = {Proceedings of the 2020 Conference on Empirical Methods in Natural Language Processing},
    month = {November},
    year = {2020},
    location = {Online}
}

If you use this code for personalized word embeddings for individual users please cite:

@InProceedings{coling20personal,
    title   = {Exploring the Value of Personalized Word Embeddings},
    author  = {Charles Welch and Jonathan K. Kummerfeld and Ver{\'o}nica P{\'e}rez-Rosas and Rada Mihalcea},
    booktitle = {Proceedings of the 28th International Conference on Computational Linguistics},
    month = {December},
    year = {2020},
    location = {Online}
}

If you want to sample and annotate new 'i am' posts you can use compose/sample_i_posts.py. The functions for extracting attributes from users are in compose/find_self_statements.py. Run this script to produce lists of users for each attribute. Replace DIR_LOC with the location of your Reddit data.

python find_self_statements.py --type gender
python find_self_statements.py --type location
python find_self_statements.py --type religion
python find_self_statements.py --type age

After running this for location, you will have files for locations in the demographic folder. You can then run resolve_locations.py from the compose folder to resolve locations to the following set, which was based on the amount of available data for each region:

1. USA
2. Asia
3. Oceania
4. United Kingdom
5. Europe
6. Africa
7. Mexico
8. South America
9. Canada

Next, run complete_authors.py --find, which will create a complete_authors file in the demographic folder, which will be used in the creation of matrix embeddings. There are a few important constants in complete_authors.py at the top of the file that can be changed:

• MAX_AGE and MIN_AGE are the range of accepted ages. If a user states that they are an age outside of this range, they will be excluded from the complete_authors list.
• MAX_RANGE is the largest accepted difference in stated ages. This acts as a simple heuristic to exclude users with incorrect ages. For instance, if a user states they are 20 in 2002 and 30 in 2003, this would not be possible. Our data spans 9 years, so we default this value to 9.
• N_UNKS is the criterion number of unknown demographic values that causes a user to be excluded. If you would like no users to be excluded, set this to the number of demographic variables plus one (4+1 for us). If you would like to exclude users who have no known demographic values, set this to the number of demographic variables (4 for us).
• MIN_PERCENT is the exclusion criteria for users who state both gender identities recognized by this study. For the less often expressed value, if it exceeds the MIN_PERCENT, the user is excluded.

1. Put the speaker names for speakers of interest in top_speakers. If you would like to run find_bots_in_list.py at this point, you can and it will output the names of speakers in your file that are known bots. At this point you can manually remove them if you'd like. A script to remove them can be run at step 6.
2. Run get_ts_posts.py -p -d all to get posts from this set of speakers from all years.
3. Run merge_ts_posts.py to combine these files and output author_json files in all_posts.
4. Run preprocess_all_posts.py to preprocess all_posts/author_json files.
5. Run sentence_tokenize.py to run CoreNLP tokenizer on all posts.
6. Run rm_known_bots.py to remove files in all_posts belonging to known bots.

The highest performing embeddings described in our papers use separate matricies for each demographic value or user and are learned using Bamman et al.'s 2014 code. I have compiled separate JAR files and included separate config files for each demographic scenario. Note: If you plan to also run the language model, make sure to first separate out a sample of data for training the model.

1. First run prepare_demographic_embed_data.py to create the java_ctx_embeds_reddit_demographic file containing relevant data and the reddit_vocab file.
2. In the embeddings folder, run the shell script for each demographic (./run_VARIABLE.sh) to generate embeddings.

1. First run prepare_author_embed_data.py to create the sts_combined_users file containing text with user labels for training embeddings and a reddit_user_vocab file.
2. In the embeddings folder, run the shell script ./run_users.sh to generate embeddings.

The language model code we use is modified from Merity et al's 2018 code and is in the awd_lstm directory. The modifications allow loading of multiple pretrained embedding matrices with which to initialize the model and allows for freezing and untying embedding weights, as we found this works well when there is enough in-domain data to pretrain on.

To run with all demographic embeddings use python main.py --batch_size 20 --data /path/to/data --dropouti 0.4 --dropouth 0.25 --seed 141 --epoch 50 --save reddit_demo.pt --usepre --pre /path/to/demo/embeds/embeddings.without.suffix. --emsize 100 --burnin 99 --demouse cat --usedemo

• data is a path to a folder with a train.txt, valid.txt, and test.txt in the format used by JARs above to create embeddings.
• pre is the folder containing pretrained embeddings. The file format must have age, gender, location, or religion as the end of the filename and the parameter when running should omit this (e.g. our scripts create embeddings in this repo with the prefix embed_test_ so this would be what would be passed).
• burnin determines how many epochs for which embeddings will not be updated. Here, since it is larger than the number of epochs, they will be frozen the whole time.
• usedemo is a flag that tells the model to use demographic embeddings.
• demouse can be cat or sum and determines whether to concatenate or add demographic embeddings.
• If you would like to use one demographic instead of all, you can use useone and specify which demographic to use.
• If you have a second test set to evaluate on, use test to specify the name of the second file relative to the folder specified by data.

1. First prepare the data by running prepare_aa_data.py which will create a separate aa.txt evaluation file for each user, in addition to the train/validation/test split for training language models. The code for user models is similar to the code for the demographic language model.
2. To create a model for a single user you will use code in the single_user folder and can run python main.py --batch_size 20 --data /path/to/data/aa/ --dropouti 0.4 --dropouth 0.25 --seed 141 --epoch 50 --save /path/to/output/models/ --nhid 550 --pre /path/to/user/embedding/matrices/ --emsize 100 --usepre --burnin 99 --induse cat --name $uname --aaeval --useind

• name is the name of the user for which the model is being created.
• aaeval will run the user's model on each other user's data and produce output files with perplexities that can be used later to determine which model had the best predictions.

1. Follow the steps for creating embeddings for users above. The scripts for plotting category distributions are not currently available for demographic embeddings.
2. Run vocab_counts.py to get word frequencies per user.
3. Run compare_spaces.py to get word distances to generic embedding space per user.
4. Run plot_cats_dist.py to generate the graphs. Options are available for POS tags, LIWC, and ROGET categories. Figures can be saved or displayed with additional options, see --help for more details.

• token_counter.py outputs a file called token_counts that contains counts of tokens from all speakers in your top_speakers file.
• lexicon_map.py is used by plot_cat_dist.py to graph LIWC and ROGET word class distributions and requires the LIWC_PATH and ROGET_PATH to be set in lexicon_map.py lines 9-10
• Running complete_authors.py --plot provides some useful plots of the demographic and post distributions of the dataset.