Xoces (“X-oh-sis”) started as a research project to catalog, structure and visualize learning outcomes. We have published the process of collecting outcomes and modeling the data, and released xoces-js as an open-source JavaScript visualization library.

visualizing outcomes in a chord diagram

How can I visualize my data using Xoces?

The Xoces library requires a mapped dataset. You also need a developer on your team to set up Xoces (but it's very easy to set up). If you already have a mapped dataset, great! You can read our documentation on setting up Xoces. If you don't have a mapped dataset, and are not sure what a mapped dataset is, steps:

  1. Collect your outcomes (or the instructional data you want to visualize). In this paper, we detail the process of sitting down with faculty to collect learning outcomes at MIT.
  2. Map your collected data. Mapping data requires you to structure entities and create relationships between entities. Read more on how learning outcomes are mapped.
  3. Save the mapped data somewhere so that it can be loaded into JavaScript. We highly recommend that the data is made callable via API.
  4. Use the Xoces widget on your webpage with mapped data from Step #3

If you have code questions, please file an issue on our Github. If you have questions on process, modeling and big-picture why's, please email our lab's director, Prof. Karen Willcox [kwillcox@mit.edu].


We ask that you star our Github repository so that we can alert you to updates. We also ask that you cite our papers or link back to this page (http://mapping.mit.edu/code/xoces) if you publish any work.

Teams who have used Xoces

and more...