Skip to content

Commit

Permalink
[docs] Add uses of Tulipa (#907)
Browse files Browse the repository at this point in the history
  • Loading branch information
clizbe authored Oct 28, 2024
1 parent 56cc12d commit f615f78
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 5 deletions.
4 changes: 2 additions & 2 deletions docs/src/30-concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ _TulipaEnergyModel.jl_ incorporates two fundamental concepts that serve as the f

In a nutshell, the model guarantees a balance of energy for the various types of assets while considering the flow limits. It considers a set of [representative periods](@ref representative-periods) (e.g., days or weeks) for a given [timeframe](@ref timeframe) (e.g., a year) the user wants to analyze. Therefore, the model has two types of temporal (time) constraints to consider the different chronology characteristics of the assets:

- **Intra-temporal Constraints**: These constraints limit the asset or flow within a representative period. The intra-temporal constraints help to characterize the short-term operational dynamics of the assets. So far, the model considers balance and flow limitations within the representative period, but future developments will include unit commitment, ramping, and reserve constraints.
- **Inter-temporal Constraints**: These constraints combine the information of the representative periods and create limitations between them to recover chronological information across the whole timeframe. The inter-temporal constraints help to characterize the long-term operational dynamics of the assets (e.g., seasonality). So far, the model uses this type of constraint to model seasonal storage. Still, future developments will include, for example, maximum or minimum production/consumption for a year (or any timeframe).
- **Intra-temporal Constraints**: These constraints limit the asset or flow within a representative period. The intra-temporal constraints help to characterize the short-term operational dynamics of the assets. So far, the model considers balance and flow limitations within the representative period, as well as unit commitment and ramping. In the future, reserve constraints will also be included.
- **Inter-temporal Constraints**: These constraints combine the information of the representative periods and create limitations between them to recover chronological information across the whole timeframe. The inter-temporal constraints help to characterize the long-term operational dynamics of the assets (e.g., seasonality). So far, the model uses this type of constraint to model seasonal storage. Future developments will include, for example, maximum or minimum production/consumption for a year (or any timeframe).

The [`mathematical formulation`](@ref formulation) shows an overview of these constraints and the variables in the model.

Expand Down
33 changes: 30 additions & 3 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,43 @@ CurrentModule = TulipaEnergyModel

[TulipaEnergyModel.jl](https://github.com/TulipaEnergy/TulipaEnergyModel.jl) is an optimization model for the electricity market that can be coupled with other energy sectors (e.g., hydrogen, heat, natural gas, etc.). The optimization model determines the optimal investment and operation decisions for different types of assets (e.g., producers, consumers, conversion, storage, and transport). _TulipaEnergyModel.jl_ is developed in [Julia](https://julialang.org/) and depends on the [JuMP.jl](https://github.com/jump-dev/JuMP.jl) package.

## Tulipa in a Nutshell

### Example Questions

Tulipa can answer questions such as:

- How much flexible energy supply and demand is available? How much is needed in the future?
- How will different investment decisions impact the balance and generation mix of the energy system?
- Where will there be grid congestion in the future? How would placing [technology] at [location] impact congestion?
- How will [national/international] policy targets influence investment and dispatch?
- How will a future energy system handle different weather patterns and extreme events (such as dunkelflaute)?

Not sure if Tulipa is right for your research? Feel free to ask in our [Discussions](https://github.com/TulipaEnergy/TulipaEnergyModel.jl/discussions/categories/q-a)!

### Scope & Features

For modellers, here is a brief summary of Tulipa's scope and features. More details can be found in the [Concepts](@ref concepts) or [Formulation](@ref formulation).

- Optimisation Objective: Minimize total system cost for investment & dispatch
- Geographic scope: Flexible/Anywhere - Region/Country/Continent
- Energy carriers: Any/All - electricity, gas, H2, heat, etc
- Timespan: Any - Usually Yearly or Multi-year
- Time resolution: [Fully-flexible](@ref flex-time-res) - even mixing different resolutions (1-hr, 2-hr, 3-hr, etc) within a scenario
- Temporal aggregation: Time series aggregation using blended representative periods
- Storage representation: [Short- and Long-term storage](@ref storage-modeling) constraints, even while using representative periods
- Solutions: Optimal & Near-optimal alternatives, using modelling to generate alternatives (MGA)

## Getting Started

To start using Tulipa for your research, check out our [How to Use](@ref how-to-use) section and [Tutorials](@ref tutorials).
To start using TulipaEnergyModel for your research, check out our [How to Use](@ref how-to-use) section and [Tutorials](@ref tutorials).

For a more technical explanation, check out the [Concepts](@ref concepts) section, or dive into the [Mathematical Formulation](@ref formulation).

## [Bug reports and discussions](@id bugs-and-discussions)

If you think you have found a bug, feel free to open an [issue](https://github.com/TulipaEnergy/TulipaEnergyModel.jl/issues).
If you have a general question or idea, start a discussion [here](https://github.com/TulipaEnergy/TulipaEnergyModel.jl/discussions).
If you think you have found a bug, feel free to open an [Issue](https://github.com/TulipaEnergy/TulipaEnergyModel.jl/issues).
If you have a general question or idea, start a [Discussion](https://github.com/TulipaEnergy/TulipaEnergyModel.jl/discussions).

## Contributing

Expand Down

0 comments on commit f615f78

Please sign in to comment.