conditionals in gams - department of agricultural...

Background Features LHS & RHS Practices Alternatives

Conditionals in GAMS

Pei Huang1

1Department of Agricultural Economics

Texas A&M University

Based on materials written by Gillig & McCarl and improved upon by many previous lab instructors

Special thanks to Mario Andres Fernandez

Pei Huang | Texas A&M University | AGEC 641 Lab Session, Fall 2013 1 / 20

Outline

1 Background

2 Syntax

3 LHS & RHS

4 Using Conditionals

5 Alternatives

What is conditional?

We often wish to have terms present in the algebraic expression only

IF certain conditions are met.

The syntax of conditional in GAMS is the dollar sign $, which is read

as �if�.

$ is the counterpart of logical syntax �if� in other programming

languages, say Visual Basic, C, C++.

How it works?

Example

Say index(i) has 40 elements but we only want to sum over the �rst 20. The algebraicexpression is

∑i=1

GAMS code:X=sum(index$(ord(i) le 20),Z(i));

Example

The formula can only be calculated if it meets the condition

pivot =min

)∀i , s.t. ai > 0.

GAMS code:Pivot=smin(index$(a(i)>0),b(i)/a(i));

How it works?

Example

Say index(i) has 40 elements but we only want to sum over the �rst 20. The algebraicexpression is

∑i=1

GAMS code:X=sum(index$(ord(i) le 20),Z(i));

Example

The formula can only be calculated if it meets the condition

pivot =min

)∀i , s.t. ai > 0.

GAMS code:Pivot=smin(index$(a(i)>0),b(i)/a(i));

Conditionals - $

Conditionals are used to control in GAMS

whether an item is calculated on an element by element basis.the inclusion of terms in equations.the inclusion of set dependent terms in sums.the inclusion of equations in a model on an element by element basis.whether a display is output to *.lst �le.

Conditionals - $

whether an item is calculated on an element by element basis.

the inclusion of terms in equations.the inclusion of set dependent terms in sums.the inclusion of equations in a model on an element by element basis.whether a display is output to *.lst �le.

Conditionals - $

whether an item is calculated on an element by element basis.the inclusion of terms in equations.

the inclusion of set dependent terms in sums.the inclusion of equations in a model on an element by element basis.whether a display is output to *.lst �le.

Conditionals - $

whether an item is calculated on an element by element basis.the inclusion of terms in equations.the inclusion of set dependent terms in sums.

the inclusion of equations in a model on an element by element basis.whether a display is output to *.lst �le.

Conditionals - $

whether an item is calculated on an element by element basis.the inclusion of terms in equations.the inclusion of set dependent terms in sums.the inclusion of equations in a model on an element by element basis.

whether a display is output to *.lst �le.

Conditionals - $

whether an item is calculated on an element by element basis.the inclusion of terms in equations.the inclusion of set dependent terms in sums.the inclusion of equations in a model on an element by element basis.whether a display is output to *.lst �le.

Examples

Whether an item is calculated

X $(Y gt 0)= 10;qq $(sum(i,q(i))gt 0 )= 4;

Whether elements of an item are computed

Q(i)$(a(i)gt 0)= -a(i);A(i)$(abs(a(i))gt 0)= q(i)*a(i);

Examples

Whether an item is calculated

X $(Y gt 0)= 10;qq $(sum(i,q(i))gt 0 )= 4;

Whether elements of an item are computed

Q(i)$(a(i)gt 0)= -a(i);A(i)$(abs(a(i))gt 0)= q(i)*a(i);

Examples

Controlling inclusion of terms in equations

Eq3$(x=2).. zz=e=3;x = sum(i,q(i))$(qq gt 0)+ 4);Eq4$(x<2).. zz=e=3;

Controlling inclusion of set dependent terms

X = sum(i$(q(i)gt 0), a(i));Loop((k,j)$(cost(i,j)lt 0), x = x + cost(i,j);X = smin(i$(sum(j, cost(i,j))gt 0), q(i));

Examples

Controlling inclusion of terms in equations

Eq3$(x=2).. zz=e=3;x = sum(i,q(i))$(qq gt 0)+ 4);Eq4$(x<2).. zz=e=3;

Controlling inclusion of set dependent terms

X = sum(i$(q(i)gt 0), a(i));Loop((k,j)$(cost(i,j)lt 0), x = x + cost(i,j);X = smin(i$(sum(j, cost(i,j))gt 0), q(i));

LHS and RHS Conditionals

LHS conditionals will return the prior value when the case is not true.

Example

Q(i)= 5;Q(i)$(a(i)gt 0)= (a(i)+1);If the condition is not true, what is the value for Q(i)?

RHS conditionals will return zero when the case is not true.

Example

Q(i)= 5;Q(i)= (a(i)+1)$(a(i)gt 0);If the condition is not true, what is the value for Q(i)?

Example

LHS Conditionals

ItemName$(logical condition) = Term;

ItemName is set equal to Term only if the condition is true.

Example

SCALAR X, Y ;Y = 3;X = 1;X$(Y gt 2.5)= 2;Solution: X = 2

Example

LHS Conditionals

Example

LHS Conditionals

Example

LHS Conditionals

ItemName = Term$(logical condition);

Example

SCALAR X, Y ;Y = 3;X = 1;X = 2$(Y gt 2.5);Solution: X = 2

Example

LHS Conditionals

Example

LHS Conditionals

Example

Equation Conditionals

EquationName$(logical condition)..

Restrict whether equations are de�ned in a model.

We can restrict whether to

include the crops that do not

have minimum land requirement

by equation conditionals.

Without Equation Conditional

Include all equations

Use LIMROW option to display equation listings

With Equation Conditional

Only include equations with positive minimum land requirement

Use LIMROW option to display equation listings

SAMEAS Statement

Perform an operation only if a set element text is matched exactly to

another set element text.

The $ command says to operate the sum if i and j are the exact same

Example

X = SUM((i, j)$(SAMEAS(i,j)),c(i, j));

A Transportation Example

No transport from Chicago to Chicago

Nesting Conditionals

Nested $: statements can involve multiple $ conditions with the

following logical syntax

and: two or more conditionals apply simultaneouslyor: at least one of two or more conditionals applynot: do something when a conditional is not true

Examples

u(k)$(s(k)and t(k))= a(k);u(k)$([not s(k)] and u(k)or t(k))= a(k);u(k)$(s(k)or u(k)and t(k))= a(k);u(k)$(s(k)or [not u(k)and t(k)])= a(k);U(k)$(s(k)$t(k))= a(k);

Use di�erent levels of parenthesis to control the precedence of

calculations.

Examples

calculations.

Examples

calculations.

Alternative to Conditionals: Subset

Example

Consider the example again. Say index(i) has 40 elements but we only want to sumover the �rst 20. The algebraic expression is

∑i=1

As an alternative, create a subset for �rst 20 elements:

Set subset(i)/i1*i20/;

X=sum(i$subset(i), z(i));

X=sum(subset, z(subset));

X=sum(subset(i), z(i));

Alternative to Conditionals: Tuples

Sometimes, the same conditional appear repeatedly. We can �rst

de�ne tuples, and then use these tuples directly in equations.

A tuple refers to a set de�ned over other sets.

Example

Tcosteq..Tcost =e= sum((plant,market)$(supply(plant)and demand(market)and distance(plant,market)), shipments(plant, market)* cost(plant,market));

Rule out non-zero supply, demand, and distance in the transportation

example. The condition $(supply(plant) anddemand(market) and distance(plant,market)) mayappear multiple times in the model.

Example

Tuples

Example

SET thistuple(plant,market)Tuple expressing conditional;

thistuple(plant,market)$(supply(plant)and demand(market)anddistance(plant,market))=yes;

Tcosteq..

Tcost =e= sum(thistuple(plant,market), shipments(plant,market)*cost(plant, market));

Appendix

Heads On 4

I will email you the question and requirement.

You send an electronic copy of your *.gms �le via email. Put your

name in �rst line as comment.

Hand in a hard copy of *.lst �le (from �Solution Report� to the end).

conditionals in gams - department of agricultural...

Documents