Home

Welcome to the ExeTera wiki!

Please ensure you have read the README. You'll find the basic instructions for getting started there.

ExeTera topics

This wiki contains pages on a number of topics that should help you get up to speed using ExeTera with your dataset. These topics are:

• What is ExeTera
• Concepts
• Datatypes
• Importing data into Exetera
  • Importing via the exetera import command
  • Importing through code
  • The ExeTera data schema
• Key ExeTera classes
  • Session
  • Dataset
  • DataFrame
  • Field
• ExeTera API examples
  • Pre 0.5
    • Basic examples
    • Intermediate examples
  • 0.5 onwards
    • Basic examples
    • Intermediate examples
    • How to update your code
    • Extended examples
• ExeTera documentation
  • This Wiki!
  • readthedocs.io
• Using ExeTera with R
• Roadmap
• ChangeLog

Can't find what you are looking for?

Please raise an issue so that additional examples can be provided.

Concepts

See Concepts for the basic concepts behind the file format and datatypes built on top of hdf5.

The data schema

See Data Schema for a detailed definition of the data schema and how to define it for a given dataset.

What does the import script generate?

See Import Script for a detailed definition of what is generated by the import script.

What does the processing script generate?

See Processing Script for a detailed definition of what is generated by the processing script.

Examples

Examples are currently split up into Basic Examples that are intended to get you opening datasets and reading and writing fields, and Intermediate Examples that get you into filtering, sorting and merging fields and groups. We are also planning to create a toy dataset and you can play with in a series of more extended examples through jupyter notebooks. Until then, please take a look at ExeTeraCovid's collection of tutorial notebooks for larger examples of how to use ExeTera.

Documentation

This wiki covers the key concepts behind ExeTera's design and provides you with a number of examples to get started with making use of ExeTera on your datasets.

API documentation can be found at readthedocs.io. This is quite new, and so you may still prefer to look at the docstrings in the codebase.

Usage with python

Having run exetera import, you should have a hdf5 file containing the fields imported from the source csv files, along with additional fields that have been generated from the source data. Once this is done, you can query fields, run custom analyses and write additional fields to your dataset (or to additional files).

Refactors

See Refactors for details on the near-term and longer-term changes to the API