Welcome to julearn’s documentation!

… a user-oriented machine-learning library.

What is Julearn?

At the Applied Machine Learning (AML) group, as part of the Institute of Neuroscience and Medicine - Brain and Behaviour (INM-7), we thought that using ML in research could be simpler.

In the same way as seaborn provides an abstraction of matplotlib’s functionality aiming for powerful data visualization with minor coding, we built julearn on top of scikit-learn.

Julearn is a library that provides users with the possibility of easy testing ML models directly from pandas dataframes, while keeping the flexibiliy of using scikit-learn’s models.

To get started with Julearn just keep reading here. Additionally You can check out our video tutorial.

Why Julearn?

Why not just using scikit-learn? Julearn offers three essential benefits:

1. You can do machine learning with less amount of code than in scikit-learn

2. Julearn helps you to build and evaluate pipelines in an easy way and thereby helps you avoid data leakage!

3. It offers you nice additional functionality:

   • Easy to implement confound removal: Julearn offers you a simple way to remove confounds from your data in a cross-validated way.

   • Data typing: Julearn provides a system to specify data types for your features, and then provides you with the possibility to filter and transform your data according to these types.

   • Model inspection: Julearn provides you with a simple way to inspect your models and pipelines, and thereby helps you to understand what is going on in your pipeline.

   • Model comparison: Julearn provides out-of-the-box interactive visualizations and statistics to compare your models.

Table of Contents

• 1. Getting started
  • 1.1. Requirements
  • 1.2. Setup suggestion
  • 1.3. Installing
  • 1.4. Optional Dependencies
• 2. What you really need to know
  • 2.1. Why cross validation?
  • 2.2. Data
  • 2.3. Model Building
  • 2.4. Model evaluation
  • 2.5. Model comparison
• 3. Selected deeper topics
  • 3.1. Applying preprocessing to the target
  • 3.2. Cross-validation consistent Confound Removal
  • 3.3. Hyperparameter Tuning
  • 3.4. Inspecting Models
  • 3.5. Cross-validation splitters
  • 3.6. Stacking Models
  • 3.7. Connectome-based Predictive Modeling (CBPM)
• 4. Overview of available Pipeline Steps
  • 4.1. Transformers
  • 4.2. Models (Estimators)
• 5. Examples
  • 5.1. Starting with julearn
  • 5.2. Model Comparison
  • 5.3. Inspection
  • 5.4. Complex Models
  • 5.5. Confounds
  • 5.6. Customization
• 6. Reference
  • 6.1. Main API
  • 6.2. Pipeline
  • 6.3. Model Selection
  • 6.4. Base
  • 6.5. Inspect
  • 6.6. Models
  • 6.7. Dynamic Selection (DESLib)
  • 6.8. Scoring
  • 6.9. Scoring Metrics
  • 6.10. Transformers
  • 6.11. Target Transformers
  • 6.12. Utils
  • 6.13. Typing
  • 6.14. Prepare
  • 6.15. Stats
  • 6.16. Vizualization
• 7. Configuring julearn
• 8. Contributing to julearn
  • 8.1. Setting up the local development environment
  • 8.2. GitHub Pull Request guidelines
  • 8.3. Running unit tests
  • 8.4. Adding and building documentation
  • 8.5. Writing Examples
• 9. Maintaining
  • 9.1. Versioning
  • 9.2. Releasing a new version
• 10. Frequenly Asked Questions
  • 10.1. 2. How do I use the julearn viz interactive plots?
• 11. What’s new
  • 11.1. Julearn 0.2.5 (2022-07-21)

Indices and tables

• Index

• Module Index

• Search Page