Синтаксис пакетного управления ГНС

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:

  1. Если нужно создать или обновить сложную структуру: используйте db.InstantiateChain(command).
  2. Если нужно найти узлы по цепочке связей: используйте db.ExecutePath(query).
  3. Если нужно найти узлы по математическим условиям: используйте db.FindNodesLogical(query).

Помните: все переменные @ берутся из MainEngine.Instance.ShpScript.Variables. Перед вызовом команд убедитесь, что вы положили туда нужные данные.