AQUA
  • Introduction
    • Overview of AQUA
    • Purpose
    • Key Features
    • Contributing
  • Installation
    • Conda/Mamba installation with pip
      • Prerequisites
      • Installation with Miniforge
      • Extra dependencies
    • Conda/Mamba installation
      • Prerequisites
      • Installation with Miniforge
      • Update of the environment
    • HPC Installation
      • Installation on LUMI HPC
      • Installation on MareNostrum 5 (MN5) HPC at BSC
      • Installation on ECMWF HPC2020
    • Installation on Windows Subsystem for Linux (WSL)
    • Installation and use of the AQUA container
  • Getting Started
    • Basic Concepts
    • Python installation
    • Auxiliary files installation
    • Catalog installation
    • Set up Jupyter kernel
  • Example use case
  • The Reader class
    • The Reader
    • Input and Output formats
    • Catalog exploration
    • Reader basic usage
    • Reader and Intake parameters
    • Dask and streaming capabilities
  • The AQUA console
    • What is the AQUA console?
    • aqua install
    • aqua avail
    • aqua add <catalog>
    • aqua remove <catalog>
    • aqua set <catalog>
    • aqua list
    • aqua uninstall
    • aqua update
    • aqua fixes {add,remove} <fixes-file>
    • aqua grids {add,remove} <grid-file>
    • aqua grids set <path>
    • aqua grids deploy <grid-name>
    • aqua grids build
    • aqua drop -c <config_file> <drop-options>
    • aqua analysis <analysis-options>
  • Regrid and interpolation capabilities
    • Basic usage within the Reader()
    • Basic usage of the Regridder()
    • Concept
    • Available target grids
    • Oceanic grid files naming scheme
      • Elements Description
      • Examples
    • Vertical interpolation
  • Fixer functionalities
    • Concept
    • Convention file structure
    • Fixer file structure
    • AQUA variables convention
    • Metadata Correction
      • Merge of convention and fixer
      • Variables block structure
    • Data Model and Coordinates/Dimensions Correction
    • Develop your own fix
  • Climate-DT data access
    • Obtain the credentials
    • Use Polytope engine in AQUA
  • Graphic tools
    • Plot styles
    • Single map
    • Single map with differences
    • Projections and custom maps
    • Vertical profiles
    • Vertical lines
    • Time series
    • Seasonal cycle
    • Multiple maps
    • Multiple maps with differences
  • Other core functionalities
    • Time Statistics
    • Detrend
    • Spatial Selection
    • Spatial Statistics
    • Histogram
    • Time selection
    • Level selection
    • Streaming of data
    • Accessors
      • Basic usage
      • Usage with multiple Reader instances
    • Parallel Processing
    • Data provenance
  • Container
    • Download the container image
    • Load the container
      • Load container script
    • Generate a Personal Access Token (PAT)
    • Advanced Topics
      • Running Jupyter Notebook
      • Running Jupyter Notebook within VSCode
      • Temporary Upgrade of Any Package
  • Adding new data
    • File-based sources
    • FDB-based sources
    • Experiment metadata
    • Regridding capabilities
    • Grid definitions
    • Compact catalogs with YAML override
    • Intake capabilities and kwargs data access
    • DE_340 source syntax convention
      • Models (model key)
      • Experiments (exp key)
      • Sources (source key)
  • Catalog Generator
    • aqua catgen -c <config_file> -p <portfolio>
      • Basic usage
    • Configuration file
  • DROP - Data Reduction OPerator
    • What is DROP?
    • DROP Capabilities
    • The Low Resolution Archive (LRA) Context
    • Source Naming Convention
    • Accessing DROP-generated data
    • Using DROP to process data
      • Configuration File
      • Usage
      • Parallel DROP tool
  • AQUA analysis wrapper
    • Basic usage
    • Additional options
    • Configuration file
      • Job
      • Cluster
      • Diagnostics
  • Dashboard
    • General description and main components
    • Automatic uploading of figures and documentation to aqua-web
      • Basic usage
      • Additional options
      • Returns
      • Grouping configuration file
      • AWS credentials file
    • Pushing to LUMI-O or another S3 bucket
      • Basic usage
      • Options
      • Returns
    • Multiple experiment analysis submitter
      • Basic usage
      • Options
  • Examples and Tutorials
    • Jupyter Notebooks for Various Use Cases
  • Command Line Interface tools
    • Benchmarker
    • Grids management
      • Generation of grid from data
      • ORCA grid generator
    • HPC container utilities
    • LUMI conda installation
    • Orography generator
  • Advanced Topics
    • Set up the configuration file
    • Adding a new catalog
      • Creation of the catalog folder
      • Populating the catalog
      • Adding the catalog to the AQUA package
      • Access to aqua-dvc data for developers
    • Dask access to FDB or GSV
    • Level selection and regridding
    • Reader prepocessing option
    • Enable regrid capabilities in a new machine
      • Set the machine in the catalog machine file
      • Download the grids
    • Developer notes
      • Set up environment variables
      • Add new catalogs as developer
  • API Reference
    • Drop
      • Drop.append_history()
      • Drop.check_integrity()
      • Drop.create_catalog_entry()
      • Drop.dask
      • Drop.drop_generator()
      • Drop.get_filename()
      • Drop.retrieve()
    • Fixer
      • Fixer.fixer()
      • Fixer.get_fixer_varname()
    • FldStat
      • FldStat.align_area_coordinates()
      • FldStat.align_area_dimensions()
      • FldStat.available_fldstats
      • FldStat.fldstat()
      • FldStat.integrate_over_area()
      • FldStat.select_area()
      • FldStat.sum_area()
    • GridBuilder
      • GridBuilder.GRIDTYPE_REGISTRY
      • GridBuilder.build()
    • Reader
      • Reader.detrend()
      • Reader.fldarea()
      • Reader.fldintg()
      • Reader.fldmax()
      • Reader.fldmean()
      • Reader.fldmin()
      • Reader.fldstat()
      • Reader.fldstd()
      • Reader.fldsum()
      • Reader.histogram()
      • Reader.instance
      • Reader.intake_user_parameters
      • Reader.reader_esm()
      • Reader.reader_fdb()
      • Reader.reader_intake()
      • Reader.regrid()
      • Reader.retrieve()
      • Reader.select_area()
      • Reader.set_default()
      • Reader.timfirst()
      • Reader.timhist()
      • Reader.timlast()
      • Reader.timmax()
      • Reader.timmean()
      • Reader.timmin()
      • Reader.timstat()
      • Reader.timstd()
      • Reader.timsum()
      • Reader.vertinterp()
    • Regridder
      • Regridder.loglevel
      • Regridder.logger
      • Regridder.cfg_grid_dict
      • Regridder.src_grid_name
      • Regridder.handler
      • Regridder.src_grid_dict
      • Regridder.src_horizontal_dims
      • Regridder.src_mask_dim
      • Regridder.tgt_horizontal_dims
      • Regridder.error
      • Regridder.cdo
      • Regridder.smmregridder
      • Regridder.src_grid_area
      • Regridder.tgt_grid_area
      • Regridder.masked_attrs
      • Regridder.masked_vars
      • Regridder.extra_dims
      • Regridder.areas()
      • Regridder.configure_masked_fields()
      • Regridder.initialize()
      • Regridder.regrid()
      • Regridder.weights()
    • Streaming
      • Streaming.reset()
      • Streaming.stream()
      • Streaming.stream_chunk()
    • histogram()
    • plot_hovmoller()
    • plot_lat_lon_profiles()
    • plot_maps()
    • plot_seasonal_lat_lon_profiles()
    • plot_single_map()
    • plot_single_map_diff()
    • plot_timeseries()
    • show_catalog_content()
  • Troubleshooting and FAQ
    • I am getting an error when trying to install AQUA on LUMI
      • Resource is busy
      • Pip dependency resolution
      • Permission denied
    • I am getting an error MissingGridDefinitionPathError
    • I am getting TypeError: ‘GeometryCollection’ object is not subscriptable when using plot_single_map function
    • How do I cite AQUA in my research or publications?
  • Contributing to AQUA
    • Reporting Bugs
    • Suggesting Features
    • Contributing Code
    • Documentation and Tutorials
    • Testing
      • Running Tests Locally
      • Running Tests in Parallel
      • Writing Tests
  • References and Acknowledgments
    • Citing AQUA
    • Acknowledgments
AQUA
  • Troubleshooting and FAQ
  • View page source

Troubleshooting and FAQ

This section answers frequently asked questions and addresses common issues that users may encounter when working with AQUA.

  • I am getting an error when trying to install AQUA on LUMI
    • Resource is busy
    • Pip dependency resolution
    • Permission denied
  • I am getting an error MissingGridDefinitionPathError
  • I am getting TypeError: ‘GeometryCollection’ object is not subscriptable when using plot_single_map function
  • How do I cite AQUA in my research or publications?
Previous Next

© Copyright 2024, Climate DT Team.

Built with Sphinx using a theme provided by Read the Docs.