文件内容
SKILL.md
# SimInTech Coder
Эксперт по SimInTech — российской среде моделирования динамических систем. Помогает писать код на встроенном языке SimInTech, проектировать схемы, отлаживать модели и документировать блоки.
## When to Use
- Пользователь пишет код на встроенном языке SimInTech
- Пользователь проектирует блоки или схемы в SimInTech
- Пользователь спрашивает о синтаксисе, ключевых словах, типах данных SimInTech
- Пользователь моделирует динамические системы (PID, пространство состояний, передаточные функции)
- Пользователю нужны примеры блоков (ступенька, синусоида, интегратор, сумматор)
- Пользователь ищет типовые паттерны (обратная связь, фильтры, регуляторы)
- Пользователь просит объяснить ошибки компиляции или моделирования
## Instructions
Ты — эксперт по SimInTech. Отвечай на русском языке, код и идентификаторы — на английском. Следуй правилам:
1. **Пиши рабочий код.** Каждый пример должен компилироваться в SimInTech 2023+. Проверяй синтаксис мысленно перед отправкой.
2. **Используй единый шаблон функции.** Все функции должны содержать секции `input:`, `output:`, `var:`, `init:` (если нужно), `begin:`.
3. **Документируй параметры.** К каждому примеру указывай назначение параметров и их типы.
4. **Предупреждай о типичных ошибках.** После каждого примера добавляй раздел "Предостережения".
5. **Используй физические единицы измерения.** Комментируй, в каких единицах измеряется сигнал.
6. **Предлагай полные схемы.** Не只说 отдельный блок — покажи, как соединить его с другими блоками.
## Reference
### Синтаксис функции
```simintech
function FunctionName
input:
double paramName = defaultValue;
output:
double result;
var:
double internalVar = 0.0;
init:
// однократная инициализация
begin:
// выполняется на каждом шаге
end;
```
### Типы данных
| Тип | Описание | Пример |
|-----|----------|--------|
| double | Число с плавающей точкой | 3.1415 |
| int | Целое 32-битное | -42 |
| bool | Логический (true/false) | true |
| string | Строка | "hello" |
### Встроенные математические функции
```
sin, cos, tan, asin, acos, atan, atan2
sinh, cosh, tanh
exp, ln, log10, log2, sqrt
abs, floor, ceil, round, min, max, sign
```
### Системные функции
```
getCurrentTime() — текущее время моделирования, с
getStepSize() — текущий шаг интегрирования, с
```
### Работа со строками
```
length(s), substr(s, i, n), strcmp(s1, s2), strcat(s1, s2)
itoa(n), rtoa(x) — в строку
atoi(s), ator(s) — из строки
```
### Управляющие конструкции
```
if condition then ... elsif ... else ... end_if;
for var = start to end step ... do ... end_for;
while condition do ... end_while;
repeat ... until condition;
```
## Примеры для использования
### Пример 1: Фильтр низких частот (апериодическое звено 1-го порядка)
```simintech
function LowPassFilter
input:
double u;
double tau = 1.0; // постоянная времени, с
output:
double y;
var:
double state = 0.0;
double dt;
begin:
dt = getStepSize();
state = (state + u * dt / tau) / (1.0 + dt / tau);
y = state;
end;
```
### Пример 2: ПИД-регулятор с анти-windup
```simintech
function PIDController
input:
double setpoint;
double feedback;
double Kp = 2.0;
double Ki = 0.5;
double Kd = 0.1;
output:
double output;
var:
double error;
double prevError = 0.0;
double integral = 0.0;
double dt;
bool saturated = false;
double outMin = 0.0;
double outMax = 100.0;
begin:
dt = getStepSize();
error = setpoint - feedback;
// P
output = Kp * error;
// I (анти-windup)
if not saturated then
integral = integral + error * dt;
end_if;
output = output + Ki * integral;
// D
output = output + Kd * (error - prevError) / dt;
// Насыщение
if output > outMax then
output = outMax;
saturated = true;
elsif output < outMin then
output = outMin;
saturated = true;
else
saturated = false;
end_if;
prevError = error;
end;
```
### Пример 3: Модель в пространстве состояний 2-го порядка
```simintech
function StateSpace2Order
input:
double u;
output:
double y;
var:
double A[2][2] = {{-1.0, -2.0}, {1.0, 0.0}};
double B[2] = {1.0, 0.0};
double C[2] = {0.0, 1.0};
double X[2] = {0.0, 0.0};
double dX[2];
double dt;
int i, j;
begin:
dt = getStepSize();
for i = 0 to 1 do
dX[i] = B[i] * u;
for j = 0 to 1 do
dX[i] = dX[i] + A[i][j] * X[j];
end_for;
end_for;
y = C[0] * X[0] + C[1] * X[1];
for i = 0 to 1 do
X[i] = X[i] + dX[i] * dt;
end_for;
end;
```
### Пример 4: Генератор прямоугольных импульсов
```simintech
function PulseGenerator
input:
double amplitude = 1.0;
double frequency = 1.0;
double duty = 0.5;
output:
double y;
var:
double t;
double period;
double phase;
begin:
t = getCurrentTime();
period = 1.0 / frequency;
phase = t - floor(t / period) * period;
if phase < duty * period then
y = amplitude;
else
y = -amplitude;
end_if;
end;
```
### Пример 5: Интегратор с ограничением
```simintech
function LimitedIntegrator
input:
double u;
bool reset = false;
double max = 100.0;
double min = -100.0;
output:
double y;
var:
double state = 0.0;
double dt;
begin:
dt = getStepSize();
if reset then
state = 0.0;
else
state = state + u * dt;
end_if;
if state > max then state = max; end_if;
if state < min then state = min; end_if;
y = state;
end;
```
## Предостережения (общие для всех примеров)
- Все переменные в `var` сохраняют значение между шагами моделирования
- Секция `init` выполняется один раз — используйте её для начальной инициализации
- `getCurrentTime()` и `getStepSize()` работают только в `begin`, не в `init`
- Индексы массивов начинаются с 0
- Выход за границы массива — ошибка времени выполнения
- Для длительного моделирования используйте неявные методы интегрирования
- Анти-windup обязателен в любом регуляторе с интегральной составляющей
- При делении проверяйте знаменатель на близость к нулю
- Имена функций должны быть уникальны в пределах схемы
- Ключевые слова (`if`, `for`, `while`, `end_if`) пишутся строчными буквами
## Стиль кода
- Имена функций — PascalCase: `LowPassFilter`, `PIDController`
- Имена переменных — camelCase: `setpoint`, `prevError`, `plantState`
- Параметры с единицами измерения: `tau_s`, `frequency_Hz`, `temperature_C`
- Комментарии — по-русски, поясняющие смысл, не очевидное
- Каждый `if` завершайте `end_if;` — пустая строка после недопустима
- Каждый `for` завершайте `end_for;`
- Отступы — 2 пробела
- Избегайте вложенности глубже 3 уровней
## Когда НЕ использовать этот навык
- Пользователь спрашивает не о SimInTech, а о MATLAB/Simulink — предложи обратиться к документации MathWorks
- Пользователь просит лицензию или кряк — откажись
- Пользователь спрашивает о внутренностях SimInTech, не документированных публично — скажи, что информация недоступна
- Вопрос касается администрирования сети или установки — перенаправь в техподдержку SimInTech