Синтаксис пакетного управления ГНС
1. Базовый синтаксис (Основы)
- Узел: (Schema:Name {key=val; flag})
- Ребро: -[Tag1, Tag2 {weight=1.0}]->
- Цепочка: (A) -[link]-> (B) -[link]-> (C)
- Принцип Upsert: если узел с таким Schema:Name уже есть, он не дублируется, а обновляется (добавляются новые свойства из {…}).
2. Динамика и Макросы (Препроцессор @)
Перед выполнением любой команды движок ищет символы @ и заменяет их значениями из C#-скрипт движка (ShpScript).
- @VarName: Простая подстановка переменной.
- @VarName[Default]: Подстановка с защитой (если переменной нет, используется Default).
- @(…): Вычисление любого C#-выражения “на лету”.
- Пример: (Node {val=@(Math.Sin(45) * 100)})
3. Прототипы и Наследование (Ключевое слово FROM)
Используется в методе db.InstantiateChain(). Позволяет копировать “генетику” (свойства и связи) из существующих узлов-шаблонов.
- Синтаксис: (НовыйУзел FROM Прототип {переопределение_свойств})
- Ребро: -[Связь FROM ШаблонРебра]->
- Логика: сначала копируются все свойства прототипа, затем применяются свойства из фигурных скобок {…} (новые добавляются, старые перезаписываются).
4. Поиск и Маршрутизация (Пути / и \)
Используется в методе db.ExecutePath(). Позволяет ходить по связям как по файловой системе.
- /Tag: Шаг вперед по исходящей связи с тегом Tag.
- \Tag: Шаг назад по входящей связи с тегом Tag.
- =>Filter: Фильтрация текущего списка узлов.
5. Практические Примеры
5.1. Простое создание с переменными
// sh='Net', name='Sensor1'
(@sh:@name {type="input"; active})
Результат: создаст узел Net:Sensor1 со свойствами type=”input” и active=”true”.
5.2. Инстанцирование нейрона по шаблону
(Layer1:N1 FROM Models:ReluNeuron)
Результат: создаст Layer1:N1, скопировав все настройки (триггеры, веса) из Models:ReluNeuron.
5.3. Переопределение свойств прототипа
(Layer1:N2 FROM Models:ReluNeuron {threshold=0.8; _importance=100})
Результат: создаст нейрон, но заменит его порог на 0.8, даже если в шаблоне было 0.5.
5.4. Создание связи по прототипу (Синапс)
(A) -[syn1 FROM Models:ExcitatorySynapse {w=2.5}]-> (B)
Результат: Связь syn1 унаследует все параметры “Возбуждающего синапса”, но получит индивидуальный вес 2.5.
5.5. Полностью динамическая сборка
(@layer:@id FROM @proto {@key=@val})
Результат: Все параметры (схема, имя, шаблон, свойства) подставятся из C# переменных.
5.6. Смешанная цепочка (Старый + Новый)
(ExistingNode) -[link]-> (NewNode FROM Models:BaseTemplate)
Результат: найдет уже существующий узел и пробросит от него связь к новому узлу, созданному по шаблону.
5.7. Использование вычислимых выражений
(Neuron {weight=@(Rand.NextDouble()); timestamp=@(DateTime.Now.Ticks)})
Результат: при каждом вызове будут генерироваться новые случайные числа и время.
5.8. Маршрутизация: Поиск “дедушки”
(User:Andrey) \child \child => User:*
Результат: найдет всех, чьим “внуком” является Андрей.
5.9. Сложная навигация (Кто охотится на моих врагов)
*:Кот /враг /враг \охотится => Птица:*
Результат: пройдет путь: Кот → его Враги → Враги врагов → Кто на них охотится → Фильтр “Птицы”.
5.10. Логический поиск с WHERE
Sensor:* {type=temp} WHERE value > @(GlobalThreshold + 10)
Результат: найдет все датчики температуры, значение которых выше динамического порога.
5.11. Массовое создание в цикле (через C#)
// C#
for(int i=0; i<3; i++)
db.InstantiateChain($"(Cell:{i}) -[step]-> (Cell:{i+1} FROM Models:Proto)");
Результат: создаст цепочку нейронов, где каждый следующий узел создается по шаблону.
5.12. “Умное” связывание (Side-effects)
(Task:Main) -[sub @(lastId = CreateSubTask(); "link")]-> (Task:@lastId)
Результат: Скрипт внутри @(…) выполнит функцию CreateSubTask(), сохранит результат в переменную lastId, и эта же переменная тут же подставится в имя целевого узла.
Рекомендации по использованию API:
- Если нужно создать или обновить сложную структуру: используйте db.InstantiateChain(command).
- Если нужно найти узлы по цепочке связей: используйте db.ExecutePath(query).
- Если нужно найти узлы по математическим условиям: используйте db.FindNodesLogical(query).
Помните: все переменные @ берутся из MainEngine.Instance.ShpScript.Variables. Перед вызовом команд убедитесь, что вы положили туда нужные данные.