upunaprosk/moral_stories

Example usage in Colab

!git clone https://github.com/demelin/moral_stories.git
%cd moral_stories
!while read requirement; do pip install "$requirement" || echo "Skipping $requirement"; done < requirements.txt

Data Processing:

!wget -O moral_stories_datasets.tar.xz "https://drive.google.com/uc?id=1qze2jHi0Ed5dY7Cse55E34wVzeSGTvQs&export=download"
!tar xf moral_stories_datasets.tar.xz
!mv -v moral_stories_datasets data
%cd data
!for i in $(ls -d classification/*); do echo $i; ln -s $i "`basename ${i}`_cls"; done
!for i in $(ls -d generation/*); do echo $i; ln -s $i "`basename ${i}`_gen"; done
%cd ..

Test for generation:

!python3 ./experiments/run_baseline_experiment.py \
--model_type bart \
--model_name_or_path facebook/bart-large \
--task_name action\|context_gen \
--split_name norm_distance \
--do_eval \
--do_prediction \
--do_lower_case \
--do_sample \
--data_dir ./data \
--max_seq_length 100 \
--per_gpu_eval_batch_size 16 \
--per_gpu_train_batch_size 16 \
--learning_rate 5e-6 \
--gradient_accumulation_steps 8 \
--num_train_epochs 1 \
--output_dir ./output \
--do_train \
--logging_steps 500 \
--save_steps 500 \
--seed 42 \
--data_cache_dir ./cache \
--warmup_pct 0.1 \
--evaluate_during_training \
--max_gen_length 60 \
--p 0.9 \
--save_total_limit 10 \
--patience 10 \
--overwrite_output_dir

Supplementary materials for the paper "Moral Stories: Situated Reasoning about Norms, Intents, Actions, and their Consequences" (Emelin et al., 2021)

Dataset is now also available on HuggingFace: https://huggingface.co/datasets/demelin/moral_stories.
Full paper is available here: https://aclanthology.org/2021.emnlp-main.54.pdf

Abstract: In social settings, much of human behavior is governed by unspoken rules of conduct. For artificial systems to be fully integrated into social environments, adherence to such norms is a central prerequisite. We investigate whether contemporary NLG models can function as behavioral priors for systems deployed in social settings by generating action hypotheses that achieve predefined goals under moral constraints. Moreover, we examine if models can anticipate likely consequences of (im)moral actions, or explain why certain actions are preferable by generating relevant norms. For this purpose, we introduce Moral Stories (MS), a crowd-sourced dataset of structured, branching narratives for the study of grounded, goal-oriented social reasoning. Finally, we propose decoding strategies that effectively combine multiple expert models to significantly improve the quality of generated actions, consequences, and norms compared to strong baselines, e.g. though abductive reasoning.

Dataset

Overview

The Moral Stories dataset is available at https://tinyurl.com/moral-stories-data. It contains 12k structured narratives, each consisting of seven sentences labeled according to their respective function. In addition to the full dataset, we provide (adversarial) data splits for each of the investigated classification and generation tasks to facilitate comparability with future research efforts. For details regarding data collection and fine-grained corpus properties, please refer to 📘 Section 2 of the paper.

Story examples

Quickstart guide: Evaluating models on Wino-X

To get started quickly with training one of your own models, check the scripts provided in bash_scripts/.
The classification and generation models can be trained/evaluated using experiments/run_baseline_experiment.py.
Evaluation for classification can be run using the same script. To calculate metrics for generation, use experiments/compute_generation_metrics.py script on specified model generations.

Codebase details

We provide code for the replication of data curation steps as well as experiments discussed in our paper. requirements.txt specifies libraries utilized by the codebase. Example shell scripts used to run each experiment can be found in /bash_scripts whereas their Beaker analogues are provided in /beaker_scripts. The following briefly describes individual files included in the codebase:

Dataset collection

(:blue_book: See Section 2 of the paper.)

collect_sc101_writing_prompts.py: Selects suitable norms from the Social-Chemistry-101 dataset (https://tinyurl.com/y7t7g2rx) to be used as writing prompts for crowd-workers.
show_human_validation_stats.py: Summarizes and reports human judgments collected during the validation round.
remove_low_scoring_stories.py: Removes stories that received a low score from human judges during the validation round.
show_dataset_stats.py: Computes and reports various dataset statistics.
identify_latent_topics.py: Performs Latent Dirichlet Allocation to identify dominant topics in the collected narratives.

Split creation

(:blue_book: See Section 3 of the paper.)

create_action_lexical_bias_splits.py: Splits the data according to surface-level lexical correlations detected in actions.
create_consequence_lexical_bias_splits.py: Splits the data according to surface-level lexical correlations detected in consequences.
create_minimal_action_pairs_splits.py: Splits the data by placing stories with minimally different action pairs in the test set.
create_minimal_consequence_pairs_splits.py: Splits the data by placing stories with minimally different consequence pairs in the test set.
create_norm_distance_splits.py: Splits the data by placing stories with unique norms in the test set.

Experiments

(:blue_book: See Sections 3 and 4 of the paper.)

compute_generation_metrics.py: Helper script for the computation of automated generation quality estimation metrics.
compute_norm_diversity.py: Computes the diversity of generated norms based on the fraction of unique ngrams.
run_baseline_experiment.py: Runs baseline, single-model experiments for the studied classification and generation tasks.
run_coe_action_ranking_experiment.py: Runs the CoE action: ranking experiment, whereby action hypotheses are ranked according to their norm relevance.
run_coe_action_abductive_refinement_experiment.py: Runs the CoE action: abductive refinement experiment, whereby initial action hypotheses are rewritten by taking into account their expected outcomes.
run_coe_consequence_ranking_experiment.py: Runs the CoE consequence: ranking experiment, whereby consequence hypotheses are ranked according to their plausibility.
run_coe_consequence_iterative_refinement_experiment.py: Runs the CoE consequence: iterative refinement experiment, whereby initial consequence hypotheses are rewritten to increase their plausibility.
run_coe_norm_synthetic_consequences_experiment.py: Runs the CoE norm: synthetic consequences experiment, whereby norm generation takes into account expected outcomes of observed action pairs.
utils.py: Contains various utility functions for running the experiments.

Human evaluation

(:blue_book: See Section 4 of the paper.)

get_action_stats.py: Summarizes and reports human evaluation statistics for a specific action generation task.
get_consequence_stats.py: Summarizes and reports human evaluation statistics for a specific consequence generation task.
get_norm_stats.py: Summarizes and reports human evaluation statistics for a specific norm generation task.

Citation

@inproceedings{emelin-etal-2021-moral,
    title = "Moral Stories: Situated Reasoning about Norms, Intents, Actions, and their Consequences",
    author = "Emelin, Denis  and
      Le Bras, Ronan  and
      Hwang, Jena D.  and
      Forbes, Maxwell  and
      Choi, Yejin",
    booktitle = "Proceedings of the 2021 Conference on Empirical Methods in Natural Language Processing",
    month = nov,
    year = "2021",
    address = "Online and Punta Cana, Dominican Republic",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2021.emnlp-main.54",
    doi = "10.18653/v1/2021.emnlp-main.54",
    pages = "698--718",
    abstract = "In social settings, much of human behavior is governed by unspoken rules of conduct rooted in societal norms. For artificial systems to be fully integrated into social environments, adherence to such norms is a central prerequisite. To investigate whether language generation models can serve as behavioral priors for systems deployed in social settings, we evaluate their ability to generate action descriptions that achieve predefined goals under normative constraints. Moreover, we examine if models can anticipate likely consequences of actions that either observe or violate known norms, or explain why certain actions are preferable by generating relevant norm hypotheses. For this purpose, we introduce Moral Stories, a crowd-sourced dataset of structured, branching narratives for the study of grounded, goal-oriented social reasoning. Finally, we propose decoding strategies that combine multiple expert models to significantly improve the quality of generated actions, consequences, and norms compared to strong baselines.",
}

upunaprosk / moral_stories