Repository files navigation

Documentation (latest) •Documentation (main branch) •Contributing •Contact •Ask a question

Part of theFatiando a Terra project

Ensaio (Portuguese for "rehearsal") is a Python package for downloadingopen-access sample datasets for Geoscience.It taps into theFatiando a Terra FAIR data collection thatis designed for use in tutorials, documentation, and teaching.

It usesPooch to manage downloading andcaching the data on your computer.This means that datasets are only downloaded if they can't be found on yourcomputer already.

• Provide minimal code for downloading our sample data (basically just createsthe relevant Pooch code).
• Only download and let the user load the data. This helps make tutorials andexamples more easily extended to a user's own data.
• Be fully backwards compatible. We achieve this by separatingdataversions fromEnsaio versions. Data fetching functions allow you tochoose any data version that is older than the version of Ensaio that'sinstalled. Major releases of Ensaio will be few and far between (if any).

Ensaio is ready for use but still changing.This means that we sometimes break backwards compatibility as we try toimprove the software based on user experience, new ideas, better designdecisions, etc. Please keep that in mind before you update to a newerversion.

We welcome feedback and ideas! This is a great time to bring new ideas onhow we can improve the project.Join the conversation or submitissues on GitHub.

🗨️Contact us:Find out more about how to reach us atfatiando.org/contact.

👩🏾‍💻Contributing to project development:Please read ourContributing Guideto see how you can help and give feedback.

🧑🏾‍🤝‍🧑🏼Code of conduct:This project is released with aCode of Conduct.By participating in this project you agree to abide by its terms.

Imposter syndrome disclaimer:We want your help.No, really. There may be a little voice inside yourhead that is telling you that you're not ready, that you aren't skilledenough to contribute. We assure you that the little voice in your head iswrong. Most importantly,there are many valuable ways to contribute besideswriting code.

This disclaimer was adapted from theMetPy project.

This is free software: you can redistribute it and/or modify it under the termsof theBSD 3-clause License. A copy of this license is provided inLICENSE.txt.