> For the complete documentation index, see [llms.txt](https://gilestro-lab.gitbook.io/ethoscopy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gilestro-lab.gitbook.io/ethoscopy/introduction.md).

# Introduction

Welcome to Ethoscopy, a python based toolbox for the manipulation of time series data concerning sleep in biological behavioural experiments. At Ethoscopy's core is the behavpy class, a subclass of pandas that connects a metadata data frame with a data frame containing the variables of the subjects over time. This facilitates simple methods to manipulate large behavioural data sets whilst retaining the many uses and functions of pandas.

The toolbox also functions as a tool to download and standardise data produced by Ethoscopes, a machine for high-throughput analysis of *Drosophila.* 

For more information about Ethoscopes head to: <https://www.notion.so/giorgiogilestro/Ethoscope-User-Manual-a9739373ae9f4840aa45b277f2f0e3a7>&#x20;

or message a member of the Gilestro lab group for more information: [https://lab.gilest.ro](https://lab.gilest.ro/)

## Content

## Tutorial

A guide starting with how to connect and download using Ethoscopy through to data manipulation with the behavpy class

{% content-ref url="/pages/zvvczvkptUgQOz0ImJXe" %}
[Ethoscopy Workflow](/ethoscopy/getting-started/ethoscopy-workflow.md)
{% endcontent-ref %}

## Skip straight to behavpy

If you aren't using Ethoscopes or just aren't that interested, skip straight to the tutorial about the behavpy class

{% content-ref url="/pages/uNS3quZw92dbViwQffP6" %}
[Behavpy](/ethoscopy/behavpy.md)
{% endcontent-ref %}

## Jupyter Tutorials

Find here some jupyter notebooks that run through the basics, circadian analysis, and Hidden Markov Models using pre-generated data to help you get to grips with ethoscopy.

{% content-ref url="/pages/TIUhfEOxnXkSzghKArXf" %}
[Jupyter Tutorials](/ethoscopy/jupyter-tutorials.md)
{% endcontent-ref %}

## Want to deep dive?

Dive a little deeper and start exploring our API reference to get an idea of everything that's possible with the API

{% content-ref url="/pages/vV4ZBNLEdNOFuEXthdx9" %}
[API Reference](/ethoscopy/reference/api-reference.md)
{% endcontent-ref %}