# Simulator

### Simulator: RAMP - Number

```
RAMP(RATE,LOWER_LIMIT,HIGHER_LIMIT,INCREMENT)
```

* **RATE** - The number of minutes it takes to increment the value
* **LOWER\_LIMIT** - The lower limit of the value being incremented
* **HIGHER\_LIMIT** - The upper limit of the value being incremented
* **INCREMENT** - The amount with which the ramp should increase each increment

e.g. RAMP(12,10,150,7) - this creates a value that ramps up from 10 to 150, in increments of 7, every 12 minutes.

### Simulator: SIN - Number

```
SIN(LOWER_LIMIT,HIGHER_LIMIT,FREQUENCY,PHASE)
```

* **LOWER\_LIMIT** - The lower limit of the value being changed
* **HIGHER\_LIMIT** - The upper limit of the value being changed
* **FREQUENCY** - The time, in minutes, taken for the sine function to cycle
* **PHASE** - The offset in terms of frequency from the start of the oscillations. It is a value in the range of 0 to 1 where the value 0.5 move the wave forward in time by half its frequency. A value of 0 or 1 makes no change

e.g. SIN(-20,50,1,0) - this produces a sin wave with with minimum of -20, and maximum of 50, at a frequency of 1/60Hz, and no phase.

### Simulator: RANDOM - Number

```
RANDOM(LOWER_LIMIT,HIGHER_LIMIT)
```

* **LOWER\_LIMIT** - The lower limit of the value being changed
* **HIGHER\_LIMIT** - The upper limit of the value being changed

e.g. RANDOM(1,45) - a number will be randomly generated between 1 and 45 every minute.

### Simulator: PRODUCT\_COUNT - Number

```
PRODUCT_COUNT(RATE,INCREMENT)
```

* **RATE** - The number of minutes it takes for the value to increment by one. If no rate is provided, the default is 1 minute
* **INCREMENT** - The number of products to count each rate. The product count will vary +- 5% of the increment every time it is updated.

e.g. PRODUCT\_COUNT(5, 10) - the product count will increase by 10, every 5 minutes.

### Simulator: BOOLEAN - Boolean

```
BOOLEAN(RATE)
```

* **RATE** - the time in minutes until the boolean swaps. If no rate is provided, the default is 1 minute.

e.g. BOOLEAN(5) - the boolean value will switch between true and false every 5 minutes.

### Simulator: EQUIPMENT\_STATUS - Boolean

```
EQUIPMENT_STATUS_TYPE(RATE)
```

* **EQUIPMENT\_STATUS\_TYPE** - replace with the status to track from the following options:
  * EQUIPMENT\_STATUS\_RUNNING
  * EQUIPMENT\_STATUS\_STOPPED
  * EQUIPMENT\_STATUS\_BLOCKED
  * EQUIPMENT\_STATUS\_COMPLETE
  * EQUIPMENT\_STATUS\_READY
  * EQUIPMENT\_STATUS\_STARVED
  * EQUIPMENT\_STATUS\_SUSPENDED
* **RATE** - the time in minutes until the Equipment Status changes from STOPPED to RUNNING to READY etc. Only one can be true at a time.

e.g. EQUIPMENT\_STATUS\_RUNNING(5) - the "running" status will be checked to see if it is true, and the equipment status will change every 5 minutes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/edge/common-data-sources/simulator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.