Welcome to the C3.ai Digital Transformation Institute!

You have been given a grant as part of the new C3.ai Digital Transformation Institute (DTI)!
To make the start of your DTI experience as fast as possible, we have assembled a set of resources to:

  1. Introduce researchers of all stripes to the C3.ai system
  2. Help researchers determine what level of training they will need to leverage C3.ai's resources
  3. Point researchers directly to relevant documentation they will need
  4. Provide worked examples of different research workflows and how they may be ported into
    the C3.ai environment, or may use C3.ai's resources

If you have questions not covered by this guide, please contact the DTI team at the email help@c3dti.ai 

Introduction to the C3.ai system

C3.ai is a data analytics engine designed to make the ingestion and analysis of heterogeneous data sources
as painless as possible. The C3.ai platform joins data from multiple sources into a single unified federated data image.
With the federated data image defined, C3.ai then provides an API to access that data, and in the case of time-series data,
perform numerous transformations and computations all producing normalized time-series data at regular intervals.

C3.ai also supports R and Python Jupyter notebook analysis of the federated data image. These notebooks provide a
great way for researchers to analyze data close to where the data is stored. While C3.ai supports many data science
capabilities familiar to the researcher, some expected functionality may be missing. For these cases, C3.ai supports
implementing new data processing functions in python and javascript.

Like any other API porting your own workflows will take some care and time to learn properly. Please leverage this guide
to make understanding the C3.ai platform and porting your workflow as quick and easy as possible.

Services available from C3.ai

How does C3.ai differ from traditional HPC systems?

What types of software can be run on C3.ai?

What types of software cannot be run on C3.ai?

How do I get started?

Use this guide to determine what training you need to utilize C3.ai resources effectively. We have identified four
categories of usage of the C3.ai platform. We include basic examples of workflows which might fall into that level,
pros and cons of operating on that level, and a list of training resources we recommend resources researchers
completing on the DTI training environment before starting their C3.ai allocations. This will ensure researchers will
be able to use their allocation as efficiently as possible.

Examine the high level overviews of each level below, then click the section titles to go to more in-depth
discussions related to that level, like the recommended training.

Level 1: Use Public COVID-19 Datalake Only

For many researchers, accessing the public API for the COVID-19 Federated Data Image will be enough for their research goals.
The public API provides fetch access to many datalake objects, and metrics access to some time series data such as case data,
and allows you to pull local copies of those objects and metrics results into your local compute environment. 

Level 2: Full C3 Datalake Access

Full access to the Datalake offers access to all stored COVID-19 Datalake data while still allowing the researcher to use whatever
analysis framework they so choose with their own compute resources. This level offers the fastest startup time while still ensuring
access to all data. Once you learn how to query data in C3, that data can be streamed to your compute resources where you can
use your language and tools of choice.

Level 3: Define and use C3 Types to Integrate Data into C3

Some researchers will want to write their own C3 package and leverage more of the AI Suite. C3 allows researchers to
define their own types and methods to integrate their data into the C3 AI Suite – either independently or alongside the COVID-19
Datalake. This allows researchers to use C3 data analytics methods such as timeseries metrics just as they would on other
Datalake data. Researchers will also have the ability to share their data with other researchers in the DTI by sharing their package.
Adding another researcher's package as a dependency to your package will also bring another researcher's data into
your package as well.

Level 4: Advanced C3 Platform Usage

Some researchers will want to bring state-of-the-art ML workflows to C3.ai. C3.ai can support such workflows, but
extra work may be needed.

Accessing C3.ai

This section introduces the process to access C3.ai. Generally speaking, once you receive your grant,
the DTI team will reach out and discuss with you what your needs are. The process will be:

  1. Determine which researchers will require access to a C3.ai environment
  2. Each researcher will be given a C3.ai developer portal login.
  3. Each researcher will be given a tag on the C3.ai DTI training cluster.
  4. Once training is complete, discuss with the DTI team what your needs
    for a C3.ai cluster will be.
  5. The C3.ai DTI will work with C3.ai to stand up a new tag for your research.
  6. Access to that tag will be granted to your researchers
  7. Research can then proceed until your allocation is exhausted!

Essential C3.ai Concepts

C3.ai is quite different from traditional HPC resources. We have written an introduction to C3.ai from the
perspective of a scientific researcher. We go over several important C3.ai concepts and relate them to
what scientists are more familiar with.

C3.ai Allocation Management

This section introduces How researchers will be expected to manage their allocation while on the C3.ai platform.

This section will be expanded once the DTI team understands how this procedure will look to the researcher.

Special Compute Resource Information

Here you can find information about the special compute resources available to C3.ai DTI researchers.

Comprehensive List of Available Training and Resources

See the above link for a comprehensive list and categorization of the available training
materials. This includes C3.ai Documentation, DTI introductions, and DTI created examples and exercises.

Help! This guide doesn't solve my problem!

No problem! You're not alone! Please send an email to help@c3dti.ai with a description of your issue
and one of our team will work with you to resolve your issue.

Feedback

If you feel aspects of this guide are incomplete or inaccurate, please send an email to help@c3dti.ai with the
issue or suggestion, and we will work to incorporate it to make the documentation better. We appreciate the new perspective
More eyes can bring to a software project!

Your DTI Team

NCSA

Jay Roloff - Executive Director

Matthew Krafczyk - Data Analyst

Yifang Zhang - Data Analyst

Berkeley

Larry Rohrbach - Executive Director

Eric Fraser

Greg Merritt

Matt Podolsky