Create a project

In this tutorial you will learn how to create and explore a stride project.

The tutorial assumes that you have cloned the stride repository to your local system in the current directory (./stride).

  1. Create the test project.

    $ stride projects create stride/tests/data/project_input.json5 --dataset global-test
    

Upon successful completion there will be a directory called test_project in the current directory. You will use this path for subsequent commands.

  1. List the scenarios in the project. The test project include a baseline dataset as well as a second scenario with customized GDP data.

    $ stride scenarios list test_project
    
    Scenarios in project with project_id=test_project:
      baseline
      alternate_gdp
    
  2. List the data tables that are available in every scenario of each project.

    $ stride data-tables list
    
    energy_intensity gdp hdi load_shapes population
    
  3. Display a portion of a data table in the console. This shows the differences between the baseline and custom GDP tables.

    $ stride data-tables show test_project gdp --scenario baseline
    
    ┌────────────────┬───────────┬────────────┐
    │     value      │ geography │ model_year │
    │     double     │  varchar  │   int64    │
    ├────────────────┼───────────┼────────────┤
    │ 500000000000.0 │ country_1 │       2025 │
    │ 500000000000.0 │ country_1 │       2030 │
    │ 500000000000.0 │ country_1 │       2035 │
    │ 500000000000.0 │ country_1 │       2040 │
    │ 500000000000.0 │ country_1 │       2045 │
    │ 500000000000.0 │ country_1 │       2050 │
    │ 500000000000.0 │ country_1 │       2055 │
    │ 250000000000.0 │ country_2 │       2025 │
    │ 255000000000.0 │ country_2 │       2030 │
    │ 260000000000.0 │ country_2 │       2035 │
    │ 265000000000.0 │ country_2 │       2040 │
    │ 271000000000.0 │ country_2 │       2045 │
    │ 276000000000.0 │ country_2 │       2050 │
    │ 282000000000.0 │ country_2 │       2055 │
    ├────────────────┴───────────┴────────────┤
    │ 14 rows                       3 columns │
    └─────────────────────────────────────────┘
    
    $ stride data-tables show test_project gdp --scenario alternate_gdp
    
    ┌────────────────┬───────────┬────────────┐
    │     value      │ geography │ model_year │
    │     double     │  varchar  │   int64    │
    ├────────────────┼───────────┼────────────┤
    │ 510000000000.0 │ country_1 │       2025 │
    │ 510000000000.0 │ country_1 │       2030 │
    │ 510000000000.0 │ country_1 │       2035 │
    │ 510000000000.0 │ country_1 │       2040 │
    │ 510000000000.0 │ country_1 │       2045 │
    │ 510000000000.0 │ country_1 │       2050 │
    │ 510000000000.0 │ country_1 │       2055 │
    │ 260000000000.0 │ country_2 │       2025 │
    │ 265000000000.0 │ country_2 │       2030 │
    │ 270000000000.0 │ country_2 │       2035 │
    │ 275000000000.0 │ country_2 │       2040 │
    │ 281000000000.0 │ country_2 │       2045 │
    │ 286000000000.0 │ country_2 │       2050 │
    │ 292000000000.0 │ country_2 │       2055 │
    ├────────────────┴───────────┴────────────┤
    │ 14 rows                       3 columns │
    └─────────────────────────────────────────┘