How-To Guides

Download from your dashboard If you have not built the dataset already, create it with the builder. After your dataset has finished building, open your dataset dashboard. Find the relevant dataset and choose "Download." Two sampled dataset options available, including only the metadata (CSV) or metadata with n-grams/

First, you'll need to host your lesson to a git repository. Creating a Link for your Students You can generate a link at: https://binder.constellate.org/ You'll need to fill in some data about your git repository: GitHub repository name or URL Git branch, tag, or commit Path to

We recommend the following data points be included in a citation to a Constellate dataset: Creator of datasetTitle or Description (we would like to eventually allow users to put titles on their datasets, for now we recommend you describe the dataset in the citation, in place of the title)Date

This intermediate-level how-to will have you creating a static course website based on the Jupyter Book project. The official documentation has more details about the platform, but this documentation should get you up and started quickly for teaching. The site will be hosted using free hosting from GitHub Pages. These

This process will help you resolve an issue when you have installed software, such as Python, but the software is not properly recognized in the terminal. Open terminal using either Spotlight (the magnifying glass in the upper righthand corner) or navigating to Macintosh HD > Applications > Terminal Try the

One of the most challenging issues on Microsoft Windows can be resolving Path Issues. A PATH helps Git Bash or the Command Line find the appropriate application to launch. For example, you might be sure you installed Python, Git, Pip, or The Jupyter Notebook, but when you type something like:

The Constellate analytics environment is built on Binder and accepts most common data types. Constellate Dataset Builder Data We encourage teachers to use Constellate data because it is easy to create custom data using our dataset builder. Our python client makes pulling in data very easy: simply insert a dataset

Having your own data in the Constellate format can be very helpful, since it will allow you to use existing notebooks on your own data! Data cleanup and tailoring can be complex, but we offer a couple notebooks that we hope are useful to researchers. Tokenizing Text Files (More compatible

This beginner-level "how-to" will help you build custom lessons on your local computer using The Jupyter Notebook, push them to GitHub, and then create a link to share with your workshop participants. This approach is suitable for a set of 1-3 workshops. If you are teaching an entire

Building a coherent dataset is key to any text analysis.  If you are just exploring, we recommend building a very tight, subject specific dataset.  You can do this with some robust filtering, but you might also want to focus on one or two publications. Constellate provides a variety of filtering