DARF framework documentation!

This framweork can be used to plot datasets in pythong without repeating the same code over and over again. The framework is based on Seaborn and Matplotlib library and is designed to be flexible and easy to use. The plots can be easily tuned to more spohisitcated with custom setups if necessary. The main usage of this library is for scientific pubblications where given the same data sometimes you just wanted to move the legend or change the font without having to look into the codebase or hack the plot.

This application is ment to be used with configuration .ini files, in oreder to produce plots without writing python code. A minimal example is the following configuration that can be saved in a file conf.ini

[penguins]
type=dataset
origin=Online
value=penguins

[penguin-plot]
type=plot
value=boxplot
dataset=penguins
kwargs='x':'species', 'y': 'bill_length_mm'

Run darf using the just created configuration

darf -c conf.ini

DARF is going to generate the following plot:

first_plot

Refer to the plot section for more information on how to generate more complex figures. The dataset section on the opposite provides information on how to generate and manipulate datasets.

Using this framework

Installation

How to install this tool in your machine.

CLI Usage

How to use this tool from the CLI without need to write code.

API Usage

How to include this library into your code for easy plotting.

Customization

How to include new functions into the framework to personalize your plots.

Features

List of supported features and how to use them.

Examples package

A broader list of examples of how to use the framework.

Dataset Manipulation

Dataset

How to datasets are loaded into the framwork

Dataset Operations

How to manipulate the datasets

Dataset Forking

How to copy and modify an already loaded dataset

Plot Generation

Plot

How to generate simple plots

Plot level customization

Available customization options that applies to all generated plots

Figure level customization

Available customization options applicable to plots individually

User Defined Plot Functions

How to include new functions into the framework to personalize your plots.

Development

Contributing

How to contribute changes to the framework.

Development Guidelines

Guidelines the theme developers use for developing and testing changes.

Change Log

The framework development changelog.