Getting Started

Installation

• CRISP-T is a Python package that can be installed using pip and used from the command line. Your system should have Python 3.11 or higher and pip installed. You can download and install Python for your operating system here. Optionally, CRISP-T can be imported into Python scripts or Jupyter notebooks.

• uv is recommended, but not necessary.

• Installing packages in a virtual environment using pip and venv is recommended if you are not using uv.

Include machine learning features for numeric data analysis (Recommended):

pip install crisp-t[ml]

If you are doing only textual analysis, a minimal install is possible as below:

pip install crisp-t

In rare cases, you may need XGBoost for gradient boosting features (Optional):

pip install crisp-t[xg]

• Mac users need to install libomp: brew install libomp for XGBoost to work. (Needed only if you want to use XGBoost)

Data preparation

• Create a subdirectory (e.g. crisp_source) in your work directory.
• Copy all the textual data as .txt or .pdf files into this newly created directory. For example, each interview transcript is copied as a TXT or PDF file.
• Copy the numeric data as a single .csv file into this newly created directory. Please note that only one CSV file with numeric data is currently supported.
• Import data from crisp_source folder to crisp_input folder with: crisp --source crisp_source --out crisp_input. You may use any folder name.
• Ignore warnings related to PDF files.
• Data is now imported to crisp_input.
• Use --inp crisp_input in all subsequent commands to use the imported dataset.
• You may save intermediary results into a different folder using --out option if required.