В предыдущих (первой и второй) частях по работе с таблицами поиска (Revit lookup tables) вы познакомились со структурой и способами работы функции size_lookup. Рассмотрели способы и области применения данного механизма для извлечения данных по критериям поиска. Сегодня, в заключительной статье, мы поговорим о форматах данных, которые можем получать из таблиц поиска.

Для наших экспериментов будем использовать семейство, которое я создал в предыдущей статье: Переходник ПП Valtec 705 (скачать по ссылке).

Форматы извлекаемых данных

Официальная справка по функции size_lookup говорит о том, что применение данной конструкции в формуле ограничивает нас получением только числовых данных:

• Функция size_lookup предоставляет возможность поиска только числовых значений.

Возможно, так и задумывалось изначально, но пытливый ум и наличие свободного времени для экспериментов позволили открыть способ для извлечения текстовых параметров, но об этом чуть позже. Вернёмся к нашим числовым данным.

Для определения с нашими форматами данных заглянем в справку по созданию каталога типоразмеров:

Почему каталог типоразмеров и какое он имеет отношение к таблицам поиска? На самом деле таблицы поиска (lookup tables) и каталог типоразмеров имеют много общего: 

• size_lookup используется в формулах параметров семейства, возвращая определенное значение для типоразмера семейства;
• каталог типоразмеров служит для формирования целых наборов типоразмеров семейства при загрузке семейства в проект;

В первом и во втором случаях мы имеем дело с таблицами, в которых обязательно должны присутствовать столбцы данных. Только в первом случае таблицы используются для одного значения параметра (size_lookup), а во втором — для всего набора параметров типоразмера семейства. Из этого следует вывод: определение типа данных для обоих случаев одинаково.

Но в справке по каталогу типоразмеров приведены не все доступные форматы данных. Например, для площади описание заголовка столбца должно соответствовать: param_name##AREA##SQUARE_FEET. Из определения ясно, что единицами измерения будут являться квадратные футы и параметр относится к типу данных «Площадь». Данное определение распространяется на фактическое значение в самой таблице и при использовании этих данных в семействе будет автоматически конвертировано в соответствии с настройками единиц проекта семейства данной категории:

То есть, если в самой таблице будут указаны в качестве единиц квадратные футы, то в проекте значение будет переведено в метры квадратные автоматически. Об этом следует всегда помнить, записывая формулы для параметров, чтобы не получить ошибку о несоответствии типов данных.

Как узнать нужный формат данных

Каким же образом мы можем указать в заголовке таблицы нужный тип данных и его единицы? Опять же возвращаемся к каталогу типоразмеров. Если вы уже ознакомились со справкой, то наверняка попробовали экспортировать каталог типоразмеров из семейства. Именно данная процедура поможет вам безошибочно определить верный заголовок для столбца таблицы. Как говорится, лучше один раз увидеть, чем сто раз прочитать.

Создаём параметр типоразмера в семействе с интересующим нас типом данных и экспортируем каталог типоразмеров для этого семейства. Получаем текстовый файл с описанием параметров в семействе:

Теперь мы точно знаем, как необходимо описать заголовок для хранения типа данных «Площадь» в квадратных метрах:

имя_параметра##AREA##SQUARE_METERS.

2 способа настройки единиц измерения

К чему все эти разговоры про единицы измерения и типы данных? Давайте вернёмся к нашему семейству: Переходник ПП Valtec 705. В прошлой статье я записал в таблицу данные о массе муфты переходной из каталога производителя:

Я специально привёл описание заголовка именно в таком формате mass##OTHER## и обещал вернуться к этому вопросу. В каталоге производителя масса изделия приведена в граммах, у нас же в таблице значения описаны как численные данные, без привязки к конкретным единицам:

Для приведения единиц в соответствие имеются 2 варианта. Но для этого необходимо сначала создать параметр нашего семейства с единицами измерения – «Килограммы».

Тип данных «Масса» можно найти в категории «Несущие конструкции» либо же «Трубопроводы». Я выбрал категорию «Несущие конструкции»:

В таком случае заголовок для столбца таблицы будет иметь вид:

mass##MASS##KILOGRAMS.

Итак, о возможных вариантах:

1. Править саму таблицу, заголовок с описанием столбца и данные (переводить граммы в килограммы):

2. Использовать приведение данных в самой формуле параметра без изменения таблицы, но с учётом единиц в ней (в таблице подстановки оставим mass##OTHER## и данные в граммах, а в формуле просто умножим на 1 кг и разделим на 1000):

Какой вариант использовать – выбирать вам. Но в любом случае необходимо соблюдать размерность и выбранные единицы измерений для ваших данных.

Таким образом, мы рассмотрели работу с единицами измерения и возможностями приведения данных в формулах.

Извлечение текста из таблиц lookup tables

Ну и пожалуй самое интересное — работа с текстовыми значениями из таблиц поиска.

Хоть справка по использованию size_lookup и говорит нам о том, что мы можем искать только числовые значения, существует возможность получать и текстовые значения. Но при этом действует одно ограничение – из одной таблицы поиска можно извлекать только один текстовый параметр.

Почему только один? Потому что это текстовое значение извлекается только из первого столбца. Тот самый первый столбец нашей таблицы, который используется для аннотации строки данных в ней:

Еще в прошлой статье я привёл этот столбец в нужный формат – формат каталожной позиции для спецификации. Вместе с тем как я перевернул наши данные для диаметров перехода, я оставил правильное именование первого столбца:

Теперь нам необходимо создать текстовый параметр (по сути это уже может быть общий параметр, который в последующем попадает в спецификацию), не забываем про экземпляр:

Ну, и конечно же, прописываем формулу для параметра:

То есть, для того что бы получить содержимое первого столбца таблицы поиска необходимо указать “” в качестве столбца поиска параметра.

Таким вот нехитрым способом мы можем получать и текстовые значения из таблиц поиска. Если у вас возник вопрос по поводу двух и более текстовых параметров в таблицах поиска, то милости прошу в мой блог, там достаточно подробно описан способ (непростой, но рабочий).

Краткий итог третьей части обзора Lookup tables (таблиц поиска) Revit

Рассмотрение таблиц поиска (lookup tables), основы их использования и способы применения хотел бы завершить итогами 3 части статьи:

• Таблицы поиска и каталог типоразмеров имеют одинаковый формат описания столбцов данных;
• В таблицах поиска можно использовать типы данных и единицы Revit;
• В формуле параметра типоразмера можно приводить единицы измерения;
• Из таблиц поиска можно получать текстовые значения, но только один параметр в одной таблице поиска;
• В типоразмере семейства так же можно использовать общие параметры, которые можно включать в спецификацию проекта. Эти параметры так же могут принимать значения функции size_lookup.

Материал, изложенный в трех статьях по таблицам поиска, должен помочь в освоении заложенных в Revit способов автоматизации процесса информационного моделирования. Область применения данной функции (size_lookup) можно найти не только в инженерных семействах, но это уже совсем другая история….

До новых встреч, следите за обновлениями на сайте BIM2B.

Дмитрий Талалаев, эксперт BIM2B.

Блог «Revit MEP Look: Все для инженера»

В первой статье про таблицы поиска (Revit lookup tables) мы с вами познакомились с основами и принципами работы функции size_lookup. Я не зря акцентирую внимание на «функции», потому как результатом работы является возвращаемое значение поиска по определенным условиям, а не результат магических заклинаний и плясок с бубном. Задача, по сравнению с отводом, усложняется и нам необходимо теперь контролировать не один входной параметр. Но что бы в результате получить именно те данные, которые нам нужны,  необходимо будет правильно организовать саму структуру таблицы. Итак, приступим.

Создаем таблицу для перехода

Для сегодняшнего примера будем использовать простейшее инженерное параметрическое семейство – переход полипропиленовый или же муфта переходная.

Почему именно переход? У перехода, в отличие от отвода, имеются уже две величины, которые могут меняться независимо друг от друга. Эти величины есть ничто иное, как диаметры сварных труб. Для привязки к реальным значениям параметров воспользуемся муфтой переходной Valtec:

Очень хорошо, когда производители приводят чертежи своих деталей и оборудования, — нам это поможет соблюсти все заявленные габаритные размеры. Как видим, у нас имеются 2 диаметра и соответствующие значения параметров A, B и C. Я по привычке буду использовать всю доступную информацию, это маркировка и масса, вы же можете обойтись пока что без этого. Забегая немного вперед, могу сказать, что значения этих параметров пригодятся в спецификации. О том, как это можно будет сделать, я расскажу в следующей части. Сейчас же вернёмся к нашим каталожным данным – это столбцы с d1 по С.

Создадим скелет будущей таблицы поиска и начнём конечно же с первой строки, в которой пропишем столбцы данных. В моём варианте в Excel (с каталожным описанием и дополнительным столбцом массы) это выглядит так:

В первой строке описана структура таблицы, а именно:

• d1##length##millimeters – диаметр 1 в миллиметрах;
• d2##length##millimeters – диаметр 2 в миллиметрах;
• A##length##millimeters – параметр A в миллиметрах;
• B##length##millimeters – параметр B в миллиметрах;
• C##length##millimeters – параметр C в миллиметрах;
• mass##OTHER## – параметр массы в граммах;

Параметр массы с описанием единиц ##OTHER## воспринимается как число по той причине, что в Revit в категории параметров «Общие» нет массы, найти её можно в других категориях, но сейчас не об этом.

Структура таблицы готова, теперь необходимо заполнить её соответствующими данными из каталога:

В моём варианте представлена итоговая таблица, если вы заметили, в ней больше строк, чем в каталоге производителя. Я добавил дополнительные строки для дублирования каталожного номера. Сделано это для «отзеркаливания» построения геометрии. То есть: в каталоге есть переход с 25 на 20 и приведены соответствующие значения параметров для B и С. Но что если мы захотим переход не с 25 на 20, а наоборот? Можно было бы вводить дополнительные условия в семействе для определения наибольшего диаметра, а потом уже подставлять их в нужном порядке в size_lookup. Но по мне такой вариант лишь может внести лишнюю путаницу в восприятие, по этой причине я решил продублировать такие позиции с развёрнутыми значениями:

Таким образом, мы сделали таблицу универсальной — в любом направлении перехода значения для соответствующего диаметра будут правильными.

Не забываем сохранить нашу таблицу в формат CSV, то есть разделители данных запятые:

И не забываем провести финальную чистку перед загрузкой в семейство. По умолчанию, хотя Excel и пишет что разделителями буду запятые, на самом деле разделителями столбцов будут «;». Даже не смотря на то что Revit спокойно обрабатывает разделители и в виде «;» для столбцов, он не сможет отделить целую часть от дробной потому как в Excel используется «,» а программе Revit нужна «.».

Открываем в текстовом редакторе получившийся файл:

И производим замену наших разделителей (пользуемся инструментом «Правка»-«Заменить»): сначала заменяем «,» на «.», а потом «;» на «,». В итоге получаем рабочую таблицу:

На этом первый этап завершен — рабочая таблица для семейства готова!

Создаем геометрию семейства перехода

Тут уже всё намного проще и легче, какой шаблон для нашего будущего семейства использовать решать вам – я по привычке пользуюсь «Метрическая система, типовая модель».

Задаём категорию нашего семейства – «Соединительные детали трубопроводов» и указываем тип детали «Переход».

Создаём опорные плоскости и расставляем размерные зависимости с привязкой к параметрам:

В данном случае я для себя выбрал оптимальный способ формирования объемной геометрии – вращение. Но дополнительно ввёл ещё 2 параметра для толщины стенки детали и выступ для границы трубы:

В итоге получаем параметрическое семейство с привязкой к параметрам: d1,d2,A,B и C как в каталоге нашего производителя.

Настройка семейства перехода с использованием функции size_lookup

Следующий шаг — это загрузка нашей таблицы в семейство:

Теперь необходимо создать текстовый параметр для нашей таблицы:

Ну и теперь самое волшебное – заставляем всё это работать!

Имеем наши параметры семейства:

Прописываем в параметр имени таблицы поиска (в моём случае это параметр «LT») имя нашей таблицы: «Reducer» (имя таблицы может быть произвольным, оно должно совпадать с нужным именем загруженных таблиц в семействе). И теперь прописываем для наших параметров A,B и C необходимые формулы поиска значений в нашей таблице:

На примере формулы для значения параметра А разберём функцию size_lookup

size_lookup (LT, «A», 0 мм, d1, d2)

где:

LT – наш параметр с именем необходимой таблицы «Reducer»;

«A» — столбец, из которого мы получаем значение поиска;

0 мм – значение по умолчанию, если ничего не найдем. Я специально привёл значение в 0 для того что бы при построении возникала ошибка формирования типоразмера для семейства и пользователь понимал, что такой комбинации переходов не существует;

d1, d2 – это наши параметры, а точнее пара наших диаметров по комбинации значений которых и будет производиться поиск в таблице;

Если наглядно, то это выглядит именно так:

size_lookup(LT, «A», 0 мм, d1, d2)

Именно для поиска по комбинации 2х параметров (пара наших диаметров d1 и d2), мы с вами НАЧИНАЯ СО ВТОРОГО СТОЛБЦА и создали необходимое количество комбинаций для поиска. Если нам необходимо производить поиск по одному значению или комбинации  2х и более значений, то необходимо НАЧИНАЯ СО ВТОРОГО СТОЛБЦА создавать эти комбинации. А уже после них в произвольном порядке следуют столбцы с информацией которую мы с вами хотим получить.

По такому же принципу вводим формулы для параметров В и С:

size_lookup(LT, «B», 0 мм, d1, d2)

size_lookup(LT, «C», 0 мм, d1, d2)

Настройка семейства перехода: коннекторы

Ну и финальные штрихи для нашего инженерного семейства – коннекторы. Размещаем коннекторы с привязкой диаметра к параметрам d1 и d2:

Не забываем указать классификацию для систем у коннекторов «Фитинг» и проверить, что параметры d1 и d2 являются параметрами экземпляра. Связываем коннекторы и сохраняем семейство.

Достаточно теперь загрузить это семейство в проект к вашим трубам и проверить работоспособность:

Краткий итог второй части обзора Lookup tables (таблиц поиска) Revit

На этом хотел бы подвести основные итоги 2 части полного обзора Lookup tables (таблиц поиска) Revit:

• size_lookup – позволяет производить поиск по одному значению или комбинации 2х и более значений;
• При создании таблицы поиска необходимо НАЧИНАЯ СО ВТОРОГО СТОЛБЦА описывать одну или более комбинацию значений поиска;
• Значения для результатов поиска необходимо располагать ПОСЛЕ ВСЕХ СТОЛБЦОВ ПОИСКА;
• Поиск по СТОЛБЦАМ ПОИСКА происходит в порядке перечисления их в size_lookup;

В следующей, заключительной  части, мы с вами рассмотрим способы работы с различными форматами данных, их приведении в формулах и кое-что ещё…

До новых встреч, следите за обновлениями на сайте BIM2B.

Дмитрий Талалаев, эксперт BIM2B.

Блог «Revit MEP Look: Все для инженера»

Revit Lookup tables – таблицы поиска Revit (зарегистрированное расширение для файлов, содержащих значения с разделителями CSV).

Что же такое таблицы поиска и как они используются в Revit?

Как работают таблицы поиска (Revit Lookup tables)?

Основное применение таких таблиц — это семейства. Любой, кто проектировал внутренние инженерные сети, а именно — сталкивался с соединительными деталями воздуховодов либо трубопроводов, имел дело ни с чем иным, как с семействами с использованием таблиц поиска.

В тот момент, когда изменяется один параметр (чаще всего, это сечение воздуховода или диаметр трубы), вместе с ним изменяется и геометрия самого семейства. Увидеть это можно на следующем примере отвода из стандартной библиотеки Revit: 

В данном случае, значение «Наружный диаметр фитинга» зависит от значения «Диаметр». В нашем случае «Диаметр» равен 100 мм, значит, из таблицы производится выбор значения параметра «Наружный диаметр фитинга», равное 4.125 дюйма, что при пересчёте и округлении (25.4 * 4.125 = 104,775) даст 104.8 мм.

Аналогичным образом при изменении значения параметра «Диаметр» происходит поиск в таблице и пересчёт значения параметра «Наружный диаметр фитинга»: 

Реализовано это параметризованным семейством: в формуле задана зависимость геометрии от конкретных параметров семейства (в случае с отводом — это построение наружного диаметра фитинга в зависимости от номинального диаметра соединителя) и поиском этих значений параметров в файле таблицы поиска Revit (Поиск в таблице имен).  

Где найти таблицы поиска Revit?

До 2015 версии Revit все файлы таблиц поиска должны были находиться в одном месте  для возможности их использования. За это отвечает параметр в файле revit.ini — LookupTableLocation, он содержит путь по умолчанию к папке со всеми таблицами поиска.

Это было крайне неудобно по той причине, что при передаче таких семейств, приходилось копировать и файл таблицы в нужную папку. Начиная с 2015 версии Revit, разработчики решили исправить данную ситуацию и разрешили хранение таких таблиц в файле семейства.  

Теперь актуальные таблицы поиска всегда живут в самом семействе, но возможность использования таблиц из папки (параметр LookupTableLocation файла revit.ini) так же осталась. 

Структура файла таблиц поиска (Revit lookup tables)

Как говорилось ранее, файл таблицы поиска содержат значения параметров с разделителями между ними. По умолчанию в качестве разделителя для данных используется запятая “,” а для отделения дробной части значения самого параметра используется точка “.”

Если заглянуть внутрь файла таблицы поиска, то можно увидеть примерно такое содержимое:  

Для начала, разберемся с первой строкой. В нашем случае, она содержит следующий текст: «,ND##length##millimeters,FOD##length##inches».

На первый взгляд – это совершенно  непонятный набор символов. На самом деле это структура таблицы – описание (заголовки) столбцов данных. 

Для более наглядного вида я открою этот файл с помощью Excel. Но для того что бы Excel воспринял наш файл как данные с разделителями, необходимо изменить расширение с CSV на TXT:

Теперь выбираем разделители: 

Указываем запятую в качестве разделителя столбцов: 

И форматируем столбцы. Делать это лучше для значений с дробной частью, потому как Excel переведёт эти значения в дату автоматически, если оставить формат данных столбца «общий».

И в итоге получаем уже наглядное представление нашей таблицы: 

Теперь мы видим структуру таблицы именно так, как воспринимает её Revit. Наши данные хранятся в ячейках: пересечение строки и столбца. Именно по такому принципу и сам Revit получает данные из файла таблицы поиска.

Как говорилось ранее – неотъемлемой частью файла является заголовок, первая строка. Именно в ней описывается количество столбцов и формат данных, которые будут в них храниться.

Если взглянуть на первый столбец нашей шапки, то мы увидим, что он пустой, и это не ошибка! В первом столбце ВСЕГДА (!) пишется комментарий. По аналогии с каталогом типоразмеров семейств Revit, это есть ни что иное, как имя типоразмера. Вы можете использовать этот столбец  для своих целей, чаще всего в нем указывается текстовое обозначение строки данных, описание набора значения параметров.

Далее перечисляются столбцы с данными, к которым Revit получает доступ. В нашем примере это «ND##length##millimeters».

Формат описания столбца унифицирован:

«имя_столбца##тип_данных_revit##единицы_данных_revit».

Таким образом, можно понять, что в данном столбце с именем «ND» хранятся параметры типа «длина» (length) и измеряются в миллиметрах (millimeters). Так же можно распознать остальные столбцы.

После сохранения в формат CSV, записи сами разделяются запятыми. Напомню, как выглядит в итоге строка из нашего примера:

«,ND##length##millimeters,FOD##length##inches»

Работа Lookup tables в семействе Revit

Каким же образом Revit получает эти значения в нашем семействе? Для этих целей, в качестве формулы значения параметра, используется функция size_lookup. Из стандартной справки Revit можно увидеть описание её использования:

size_lookup (LookupTableName, LookupColumn, DefaultIfNotFound, LookupValue1, LookupValue2, …, LookupValueN)

LookupTableName — имя таблицы файла CSV, в котором будет производиться поиск;

LookupColumn — имя столбца, из которого будет возвращено значение результата;

DefaultIfNotFound — значение, которое будет возвращено, если значение в столбце (столбцах)  LookupValue(1-N) поиска не найдено;

LookupValue(1-N) — значение, которое требуется найти в первом, втором и последующих столбцах таблицы. (При поиске значений первый столбец пропускается).

Самая первая ошибка в понимании механизма этой функции кроется именно в понимании параметров LookupColumn и LookupValue(1-N). Для объяснения вернёмся к уточнению: «при поиске значений первый столбец пропускается». Когда речь шла о заголовке таблицы поиска, было сказано, что первый столбец ВСЕГДА используется для аннотации строки данных (комментария), поэтому поиск по столбцам производится, начиная со ВТОРОГО столбца. Наглядно для конкретного примера нашего отвода это можно отобразить в таком виде:  

Ну и детальная схема всего механизма на примере конкретной формулы: 

То есть для получения значения, сначала мы определяем имя таблицы, в которой будем производить поиск. В данном примере это сделано через параметр семейства «Поиск в таблице имен»:

Следующим параметром для нашей функции определяем, из какого столбца по итогам поиска мы хотим получить данные – «FOD». Имя указывается так, как оно определено в заголовке таблицы.

После указывается, какое значение будет возвращено функцией, если поиск не даст результатов из таблицы. В нашем случае это будет значение параметра «Номинальный диаметр» + 3.2 мм. На случай, если подходящего значения не будет найдено, а геометрию нашего отвода необходимо сформировать, то просто увеличим наш наружный диаметр фитинга на 3.2 мм от номинального диаметра.

Ну и последний параметр для функции — это непосредственно само значение, по которому мы будем искать соответствие во ВТОРОМ столбце – «Номинальный диаметр». Наша таблица должна быть построена с учетом того, что столбцы с данными, по значениям в которых будет происходить поиск, должны начинаться со ВТОРОГО столбца. А уже после них должны идти столбцы, из которых мы хотим получать соответствующие данные. В нашем примере из таблицы поиска мы получаем всего лишь одно значение – «FOD», значение наружного диаметра в дюймах для определённого значения «ND» — номинального диаметра. Поэтому в заголовке порядок столбцов именно такой: 

• первый столбец для аннотации строки данных;
• второй столбец ND — по этим значениям мы будем выбирать подходящую строку;
• третий столбец FOD — это столбец со значением в найденной строке, которое мы будем получать в результате успешного поиска.

Для правильной работы с таблицами поиска необходимо корректно создавать её структуру!

Краткий итог первой части обзора Lookup tables (таблиц поиска) Revit

На этом хочу подвести итог для первой части полного обзора Lookup tables (таблиц поиска) Revit:

• таблицы поиска используются в семействах;
• из таблиц поиска можно получать значения параметров в семействе;
• оптимальное использование таблиц поиска – параметризированные семейства;
• таблицы поиска могут храниться в семействе;
• основным разделителем столбцов в таблице поиска служит «,»;
• таблица поиска должна содержать обязательный элемент: заголовок в 1 строке;
• первый столбец ВСЕГДА содержит необязательное описание для строк данных;
• столбцы, по которым будет производиться поиск, должны располагаться сразу после первого;
• описание столбцов унифицированы, необходимо соблюдать правило описания, тип параметров и тип единиц.

На этом первая часть, знакомство с таблицами поиска и данными по структуре и описанию, завершена. Во второй части я рассмотрю основные способы использования функции size_lookup в параметрах семейства для доступа к данным в таблицах поиска. Рассмотрим простейшее параметрическое семейство в связке с таблицами поиска и поиском нескольких параметров в одной таблице.

До новых встреч, следите за обновлениями на сайте BIM2B.

Дмитрий Талалаев, эксперт BIM2B.

Блог «Revit MEP Look: Все для инженера»