CausalNLP is a practical toolkit for causal inference with text as treatment, outcome, or "controlled-for" variable.

Last update: Jan 03, 2023

Related tags

Overview

CausalNLP

CausalNLP is a practical toolkit for causal inference with text as treatment, outcome, or "controlled-for" variable.

Install

pip install -U pip
pip install causalnlp

Usage

Example: What is the causal impact of a positive review on a product click?

import pandas as pd
df = pd.read_csv('sample_data/music_seed50.tsv', sep='\t', error_bad_lines=False)

The file music_seed50.tsv is a semi-simulated dataset from here. Columns of relevance include:

Y_sim: outcome, where 1 means product was clicked and 0 means not.
text: raw text of review
rating: rating associated with review (1 through 5)
T_true: 1 means rating less than 3, 0 means rating of 5, where T_true affects the outcome Y_sim.
T_ac: an approximation of true review sentiment (T_true) created with Autocoder from raw review text
C_true:confounding categorical variable (1=audio CD, 0=other)

We'll pretend the true sentiment (i.e., review rating and T_true) is hidden and only use T_ac as the treatment variable.

Using the text_col parameter, we include the raw review text as another "controlled-for" variable.

from causalnlp.causalinference import CausalInferenceModel
from lightgbm import LGBMClassifier
cm = CausalInferenceModel(df, 
                         metalearner_type='t-learner', learner=LGBMClassifier(num_leaves=500),
                         treatment_col='T_ac', outcome_col='Y_sim', text_col='text',
                         include_cols=['C_true'])
cm.fit()

outcome column (categorical): Y_sim
treatment column: T_ac
numerical/categorical covariates: ['C_true']
text covariate: text
preprocess time:  1.1179866790771484  sec
start fitting causal inference model
time to fit causal inference model:  10.361494302749634  sec

Estimating Treatment Effects

CausalNLP supports estimation of heterogeneous treatment effects (i.e., how causal impacts vary across observations, which could be documents, emails, posts, individuals, or organizations).

We will first calculate the overall average treatment effect (or ATE), which shows that a positive review increases the probability of a click by 13 percentage points in this dataset.

Average Treatment Effect (or ATE):

print( cm.estimate_ate() )

{'ate': 0.1309311542209525}

Conditional Average Treatment Effect (or CATE): reviews that mention the word "toddler":

print( cm.estimate_ate(df['text'].str.contains('toddler')) )

{'ate': 0.15559234254638685}

Individualized Treatment Effects (or ITE):

test_df = pd.DataFrame({'T_ac' : [1], 'C_true' : [1], 
                        'text' : ['I never bought this album, but I love his music and will soon!']})
effect = cm.predict(test_df)
print(effect)

[[0.80538201]]

Model Interpretability:

print( cm.interpret(plot=False)[1][:10] )

v_music    0.079042
v_cd       0.066838
v_album    0.055168
v_like     0.040784
v_love     0.040635
C_true     0.039949
v_just     0.035671
v_song     0.035362
v_great    0.029918
v_heard    0.028373
dtype: float64

Features with the v_ prefix are word features. C_true is the categorical variable indicating whether or not the product is a CD.

Text is Optional in CausalNLP

Despite the "NLP" in CausalNLP, the library can be used for causal inference on data without text (e.g., only numerical and categorical variables). See the examples for more info.

Documentation

API documentation and additional usage examples are available at: https://amaiya.github.io/causalnlp/

How to Cite

Please cite the following paper when using CausalNLP in your work:

@article{maiya2021causalnlp,
    title={CausalNLP: A Practical Toolkit for Causal Inference with Text},
    author={Arun S. Maiya},
    year={2021},
    eprint={2106.08043},
    archivePrefix={arXiv},
    primaryClass={cs.CL},
    journal={arXiv preprint arXiv:2106.08043},
}

Llvlir - Low Level Variable Length Intermediate Representation

Low Level Variable Length Intermediate Representation Low Level Variable Length

2 Jan 24, 2022

Semi-automated OpenVINO benchmark_app with variable parameters

Semi-automated OpenVINO benchmark_app with variable parameters. User can specify multiple options for any parameters in the benchmark_app and the progam runs the benchmark with all combinations of given options.

8 Apr 11, 2022

This is a repository for a Semantic Segmentation inference API using the Gluoncv CV toolkit

BMW Semantic Segmentation GPU/CPU Inference API This is a repository for a Semantic Segmentation inference API using the Gluoncv CV toolkit. The train

56 Nov 24, 2022

This is a repository for a semantic segmentation inference API using the OpenVINO toolkit

BMW-IntelOpenVINO-Segmentation-Inference-API This is a repository for a semantic segmentation inference API using the OpenVINO toolkit. It's supported

34 Nov 24, 2022

The Medical Detection Toolkit contains 2D + 3D implementations of prevalent object detectors such as Mask R-CNN, Retina Net, Retina U-Net, as well as a training and inference framework focused on dealing with medical images.

The Medical Detection Toolkit contains 2D + 3D implementations of prevalent object detectors such as Mask R-CNN, Retina Net, Retina U-Net, as well as a training and inference framework focused on dealing with medical images.

1.2k Jan 4, 2023

A DNN inference latency prediction toolkit for accurately modeling and predicting the latency on diverse edge devices.

Note: This is an alpha (preview) version which is still under refining. nn-Meter is a novel and efficient system to accurately predict the inference l

244 Jan 6, 2023

Microsoft Cognitive Toolkit (CNTK), an open source deep-learning toolkit

CNTK Chat Windows build status Linux build status The Microsoft Cognitive Toolkit (https://cntk.ai) is a unified deep learning toolkit that describes

17.3k Dec 29, 2022

Microsoft Cognitive Toolkit (CNTK), an open source deep-learning toolkit

CNTK Chat Windows build status Linux build status The Microsoft Cognitive Toolkit (https://cntk.ai) is a unified deep learning toolkit that describes

17k Feb 11, 2021

Code for Quantifying Ignorance in Individual-Level Causal-Effect Estimates under Hidden Confounding

🍐 quince Code for Quantifying Ignorance in Individual-Level Causal-Effect Estimates under Hidden Confounding 🍐 Installation $ git clone [email protected]

19 Jun 23, 2022

Comments

Does your model support other languages than English?

Hi Amaiya, Thanks for your great package. Would you kindly let me know if your package supports languages other than English when using CausalBert?

I'm also interested in knowing whether I can exploit other Transformers models from the Huggingface hub?
question

opened by behroozazarkhalili 1

Error while fitting the model

Hi,

I ran to this bug while fitting the model. I checked the data and everything looks good. I don't get the root cause of this error.

File /opt/conda/lib/python3.8/site-packages/causalnlp/meta/slearner.py:80, in BaseSLearner.fit(self, X, treatment, y, p)
     78 mask = (treatment == group) | (treatment == self.control_name)
     79 treatment_filt = treatment[mask]
---> 80 X_filt = X[mask]
     81 y_filt = y[mask]
     83 w = (treatment_filt == group).astype(int)

IndexError: boolean index did not match indexed array along dimension 0

opened by hfarhidzadeh 1

Releases(v0.7.0)

v0.7.0(Aug 2, 2022)
0.7.0 (2022-08-02)

New:

N/A

Changed

updated dependencies

Fixed:

N/A

Source code(tar.gz)
Source code(zip)
v0.6.0(Oct 20, 2021)
0.6.0 (2021-10-20)

New:

Added model_name parameter to CausalBertModel to support other DistilBert models (e.g., multilingual)

Changed

N/A

Fixed:

N/A

Source code(tar.gz)
Source code(zip)
v0.5.0(Sep 3, 2021)
0.5.0 (2021-09-03)

New:

Added support for CausalBert

Changed

Added p parameter to CausalInferenceModel.fit and CausalInferenceModel.predict for user-supplied propensity scores in X-Learner and R-Learner.

Removed CV from propensity score computations in X-Learner and R-Learner and increase default max_iter to 10000

Fixed:

Resolved problem with CausalInferenceModel.tune_and_use_default_learner when outcome is continuous

Changed to max_iter=10000 for default LogisticRegression base learner

Source code(tar.gz)
Source code(zip)
v0.4.0(Sep 3, 2021)
0.4.0 (2021-07-20)

New:

N/A

Changed

Use LinearRegression and LogisticRegression as default base learners for s-learner.

changed parameter name of metalearner_type to method in CausalInferenceModel.

Fixed:

Resolved mis-references in _balance method (renamed from _minimize_bias).

Fixed convergence issues and factored out propensity score computations to CausalInferenceModel.compute_propensity_scores.

Source code(tar.gz)
Source code(zip)
v0.3.1(Jul 19, 2021)
0.3.1 (2021-07-19)

New:

N/A

Changed

N/A

Fixed:

Added sample_size parameter to CausalInferenceModel.evalute_robustness

Source code(tar.gz)
Source code(zip)
v0.3.0(Jul 15, 2021)
0.3.0 (2021-07-15)

New:

Added CausalInferenceModel.evaluate_robustness method to assess robustness of causal estimates using sensitivity analysis

Changed

reduced dependencies with local metalearner implementations

Fixed:

N/A

Source code(tar.gz)
Source code(zip)
v0.2.0(Jun 21, 2021)
0.2.0 (2021-06-21)

New:

key driver analysis

Changed

CausalInfererenceModel.fit returns self

Fixed:

N/A

Source code(tar.gz)
Source code(zip)
v0.1.3(Jun 17, 2021)
0.1.3 (2021-06-17)

New:

N/A

Changed

N/A

Fixed:

version fix

Source code(tar.gz)
Source code(zip)
v0.1.2(Jun 17, 2021)
0.1.2 (2021-06-17)

New:

N/A

Changed

Better interpretability and explainability of treatment effects

Fixed:

Fixes to some bugs in preprocessing

Source code(tar.gz)
Source code(zip)
v0.1.1(Jun 17, 2021)
0.1.1 (2021-06-16)

New:

N/A

Changed

Refactored DataFrame preprocessing

Fixed:

N/A

Source code(tar.gz)
Source code(zip)
v0.1.0(Jun 16, 2021)
0.1.0 (2021-06-15)

New:

First release.

Changed

N/A

Fixed:

N/A

Source code(tar.gz)
Source code(zip)

Owner

Arun S. Maiya

computer scientist

GitHub Repository https://amaiya.github.io/causalnlp/

A collection of loss functions for medical image segmentation

3.1k Jan 03, 2023

PyElecCL - Electron Monte Carlo Second Checks

PyElecCL Python program to perform second checks for electron Monte Carlo radiat

3 Feb 22, 2022

LV-BERT: Exploiting Layer Variety for BERT (Findings of ACL 2021)

LV-BERT Introduction In this repo, we introduce LV-BERT by exploiting layer variety for BERT. For detailed description and experimental results, pleas

14 Aug 24, 2022

BarcodeRattler - A Raspberry Pi Powered Barcode Reader to load a game on the Mister FPGA using MBC

Barcode Rattler A Raspberry Pi Powered Barcode Reader to load a game on the Mist

29 Oct 31, 2022

Code for "CloudAAE: Learning 6D Object Pose Regression with On-line Data Synthesis on Point Clouds" @ICRA2021

CloudAAE This is an tensorflow implementation of "CloudAAE: Learning 6D Object Pose Regression with On-line Data Synthesis on Point Clouds" Files log:

35 Nov 14, 2022

An implementation of the Contrast Predictive Coding (CPC) method to train audio features in an unsupervised fashion.

CPC_audio This code implements the Contrast Predictive Coding algorithm on audio data, as described in the paper Unsupervised Pretraining Transfers we

8 Nov 14, 2022

This repository contains the code for "SBEVNet: End-to-End Deep Stereo Layout Estimation" paper by Divam Gupta, Wei Pu, Trenton Tabor, Jeff Schneider

SBEVNet: End-to-End Deep Stereo Layout Estimation This repository contains the code for "SBEVNet: End-to-End Deep Stereo Layout Estimation" paper by D

19 Dec 17, 2022

Official implementation of Self-supervised Image-to-text and Text-to-image Synthesis

Self-supervised Image-to-text and Text-to-image Synthesis This is the official implementation of Self-supervised Image-to-text and Text-to-image Synth

6 Jul 31, 2022

Perform zero-order Hankel Transform for an 1D array (float or real valued).

perform zero-order Hankel Transform for an 1D array (float or real valued). An discrete form of Parseval theorem is guaranteed. Suit for iterative problems.

1 Jan 17, 2022

The code for the CVPR 2021 paper Neural Deformation Graphs, a novel approach for globally-consistent deformation tracking and 3D reconstruction of non-rigid objects.

Neural Deformation Graphs Project Page | Paper | Video Neural Deformation Graphs for Globally-consistent Non-rigid Reconstruction Aljaž Božič, Pablo P

134 Dec 16, 2022

Code for NeurIPS2021 submission "A Surrogate Objective Framework for Prediction+Programming with Soft Constraints"

This repository is the code for NeurIPS 2021 submission "A Surrogate Objective Framework for Prediction+Programming with Soft Constraints". Edit 2021/

10 Dec 20, 2022

4K videos with annotated masks in our ICCV2021 paper 'Internal Video Inpainting by Implicit Long-range Propagation'.

Annotated 4K Videos paper | project website | code | demo video 4K videos with annotated object masks in our ICCV2021 paper: Internal Video Inpainting

21 Nov 05, 2022

Jupyter Dock is a set of Jupyter Notebooks for performing molecular docking protocols interactively, as well as visualizing, converting file formats and analyzing the results.

173 Dec 25, 2022

MVGCN: a novel multi-view graph convolutional network (MVGCN) framework for link prediction in biomedical bipartite networks.

MVGCN MVGCN: a novel multi-view graph convolutional network (MVGCN) framework for link prediction in biomedical bipartite networks. Developer: Fu Hait

13 Dec 01, 2022

CausalNLP is a practical toolkit for causal inference with text as treatment, outcome, or "controlled-for" variable.

Related tags

Overview

CausalNLP

Install

Usage

Example: What is the causal impact of a positive review on a product click?

Estimating Treatment Effects

Text is Optional in CausalNLP

Documentation

How to Cite

You might also like...

Llvlir - Low Level Variable Length Intermediate Representation

Semi-automated OpenVINO benchmark_app with variable parameters

This is a repository for a Semantic Segmentation inference API using the Gluoncv CV toolkit

This is a repository for a semantic segmentation inference API using the OpenVINO toolkit

The Medical Detection Toolkit contains 2D + 3D implementations of prevalent object detectors such as Mask R-CNN, Retina Net, Retina U-Net, as well as a training and inference framework focused on dealing with medical images.

A DNN inference latency prediction toolkit for accurately modeling and predicting the latency on diverse edge devices.

Microsoft Cognitive Toolkit (CNTK), an open source deep-learning toolkit

Microsoft Cognitive Toolkit (CNTK), an open source deep-learning toolkit

Code for Quantifying Ignorance in Individual-Level Causal-Effect Estimates under Hidden Confounding

Comments

Does your model support other languages than English?

Error while fitting the model

Releases(v0.7.0)

v0.7.0(Aug 2, 2022)

0.7.0 (2022-08-02)

New:

Changed

Fixed:

v0.6.0(Oct 20, 2021)

0.6.0 (2021-10-20)

New:

Changed

Fixed:

v0.5.0(Sep 3, 2021)

0.5.0 (2021-09-03)

New:

Changed

Fixed:

v0.4.0(Sep 3, 2021)

0.4.0 (2021-07-20)

New:

Changed

Fixed:

v0.3.1(Jul 19, 2021)

0.3.1 (2021-07-19)

New:

Changed

Fixed:

v0.3.0(Jul 15, 2021)

0.3.0 (2021-07-15)

New:

Changed

Fixed:

v0.2.0(Jun 21, 2021)

0.2.0 (2021-06-21)

New:

Changed

Fixed:

v0.1.3(Jun 17, 2021)

0.1.3 (2021-06-17)

New:

Changed

Fixed:

v0.1.2(Jun 17, 2021)

0.1.2 (2021-06-17)

New:

Changed

Fixed:

v0.1.1(Jun 17, 2021)

0.1.1 (2021-06-16)

New:

Changed

Fixed:

v0.1.0(Jun 16, 2021)

0.1.0 (2021-06-15)

New:

Changed

Fixed: