Cal-Adapt: Analytics Engine Notebooks

The cae-notebooks repository consists of Jupyter notebooks that provide step-by-step functionality to access, analyze, and visualize available data from California's Fifth Climate Change Assessment. Tools included in the notebooks provide examples for how to work with the historical and projection climate model data on the platform, and demonstrate how to move from the climate variables provided through the Analytics Engine to actionable information that can inform decision-making and evaluate risks.

These notebooks are designed to be used as-is or as a starting point for users to adapt to their specific needs, workflows, and applications.

Warning

The climakitae package (a crucial dependency of almost all notebooks) is under active development. APIs may change between versions and notebooks in this repository may change accordingly.

Please refer to climakitae for installation instructions, documentation, and updates.

Navigating

New to Cal-Adapt: Analytics Engine, JupyterHub, or climakitae? Take a peek our navigation guide

Want a basic example of how to retrieve, visualize, and export data using climakitae? Check out the interactive_data_access_and_viz.ipynb notebook.

Looking for a specific type of notebook?
Notebooks are organized by their theme:

• Data access notebooks highlight various ways of accessing California's Fifth Climate Assessment data, including:

  • interactive_data_and_viz.ipynb
  • renewables_data_access.ipynb

• Climate profile notebooks generate climate profiles and explore profile generation methodology:

  • custom_climate_profiles.ipynb
  • typical_meteorological_year_methodology.ipynb

• Analysis notebooks investigate a climate data topic but have no specific tools associated with the notebooks, including:

  • warming_levels.ipynb
  • timeseries_transformations.ipynb
  • threshold_exceedance.ipynb

• Collaborative notebooks were co-produced with industry partners for a specific application, and may be of interest to all users, including:

  • vulnerability_assessment.ipynb
  • degree_days.ipynb

• In progress notebooks are currently in development for a specific application, and may have frequent updates before they are moved to another folder, including:

  • climate_state_finder.ipynb
  • event_finder.ipynb
  • generalized_climate_signal_selector.ipynb

About Cal-Adapt

Cal-Adapt encompasses a range of research and development efforts designed to provide access to California climate data. Cal-Adapt includes the Cal-Adapt: Analytics Engine and Cal-Adapt: Data Explorer. The Cal-Adapt: Analytics Engine is designed for complex and detailed analyses, requiring extensive data and technical or scientific expertise. The Cal-Adapt: Data Explorer is particularly useful for quick access to interactive maps and tools, providing a valuable overview of how climate change may impact various regions of the state. In our efforts to provide actionable and transparent insight using climate data, the following documentation is available:

• climakitae API documentation
• Guidance for working with climate data
• Contribution: development guidelines

Contributing

We welcome contributions! Please see our contributing guidelines for details on:

• 🐛 Reporting bugs
• 💡 Requesting features
• 🔧 Submitting code changes
• 📖 Improving documentation

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.

Related Projects

• climakitae - API for data access, exploration, manipulation, and visualization
• climakitaegui - Interactive GUI tools for climakitae

Support

• 📧 Email: analytics@cal-adapt.org
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

---

Contributors