[고급] Create a Type Calalog

Create a Type Catalog

A type catalog lists all of the types in a family, allowing you to select and load only the types you need for the current project, resulting in a smaller project file size.

To create a type catalog, you create an external text file (TXT) that contains the parameters and parameter values that create the different types in a specific family. You place this file in the same location as the family file so that when you select to load the family, the type catalog displays.

Notes

• Create type catalogs for families that contain 6 or more types.
• Parameter names are case sensitive.
• For system parameters, the parameter within the family must have a value previously defined for the type to load the value from the catalog properly.
• To have inch marks display in the type name, you must include 2 double quote symbols in the type catalog (see table).

  To display the type name...	In the type catalog, enter...
  48" x 60"	48"" x 60""
  3' - 6"	3' - 6""

The easiest way to create a type catalog is to use the Export Family Types tool on an existing family. Using this tool, you create the base type catalog and then modify the text file in a text editor.

Create a type catalog using the Export Family Types tool

1. Open a family that contains all of the parameters and data for one or more of the base types.
   Note: Only parameters that have values in the family are exported to the type catalog.
2. Click Export (Family Types).
3. In the Export As dialog, verify that the type catalog has the same name as the family, but with a .txt extension, and that it will be saved in the same directory as the family file.
4. Click Save.
5. Open the .txt file in a text editor.
   The first line in the text file is the parameter declaration. The syntax will be similar to the following:

   ,Length##length##inches,Width##length##inches,Height##length##inches

   Syntax	Description
   ,	The first character of the first line in the file is the delimiter. This character is used to separate each parameter definition.
   Length##length##inches	Defines a parameter in the family (Parameter Name##Parameter Type##Units).

6. Define additional parameters as needed, making sure to use the delimiter and syntax specified.
7. Review the second line in the type catalog. This line defines the first type. For example, the syntax for a type could be similar to the following:

   36x12x36,36,12,36

   Syntax	Description
   36x12x36	Type name.
   ,	A comma is used to separate the type name from the list of parameter values, and is also a delimiter for each parameter.
   36,12,36	Length parameter value = 36, Width parameter value = 12, Height parameter value = 36

8. Duplicate the type syntax, and modify the type name and parameter values to create additional types in the catalog.

The following table includes a sample of the types of parameters supported in a type catalog.

Type of Parameter	Parameter Declaration	Notes
Text	param_name##OTHER##
Integer	param_name##OTHER##
Number	param_name##OTHER##
Length	param_name##LENGTH##FEET
Area	param_name##AREA##SQUARE_FEET
Volume	param_name##VOLUME##CUBIC_FEET
Angle	param_name##ANGLE##DEGREES
Slope	param_name##SLOPE##SLOPE_DEGREES
Currency	param_name##CURRENCY##
URL	param_name##OTHER##
Material	param_name##OTHER##
Yes/No	param_name##OTHER##	Defined as 1 or 0 with 1 equaling Yes and 0 equaling No.
<Family Type>	param_name##OTHER##	Family name:type name with no file extension
Metadata parameters :
Keynote	Keynote##OTHER##
Model	Model##OTHER##
Manufacturer	Manufacturer##OTHER##
Type Comments	Type Comments##OTHER##
URL	URL##OTHER##
Description	Description##OTHER##
Assembly Code	Assembly Code##OTHER##
Cost	Cost##CURRENCY##

Sample text file and type catalog

Following is a sample type catalog TXT file:

,Manufacturer##other##,Length##length##centimeters,Width##length##centimeters,Height##length##centimeters
MA36x30,Revit,36.5,2.75,30
MA40x24,Revit,40.5,3.25,24

When loading the corresponding family in a project, you would see the following type catalog:

Type	Manufacturer	Length	Width	Height
MA36x30	Revit	36.5cm	2.75cm	30cm
MA40x24	Revit	40.5cm	3.25cm	24cm

A type catalog is an external text file (TXT) that contains the parameters and their values that create the different types in a specific family.

Following is a sample type catalog TXT file:

,Manufacturer##other##,Length##length##centimeters,Width##length##centimeters,Height##length##centimeters

MA36x30,Revit,36.5,2.75,30

MA40x24,Revit,40.5,3.25,24

When loading the corresponding family, you would see the following type catalog:

There are several ways to create a comma-delimited .txt file. You can type it in using a text editor like Notepad, or you can use database or spreadsheet software to automate the process.

You can export your project to a database using ODBC, and then download the element type tables in comma-delimited format. See Exporting to ODBC in the Revit Architecture 2009 Help.

As you create the type catalog, follow these rules:

■ Save the type catalog file name with a .txt extension; the file must have the same name and same directory path as the Revit Architecture family, for example, Doors/door.rfa and Doors/door.txt.

■ The left column lists types.

■ The top row of the file is for parameter declaration. Format is columnname##type##unit.

■ Use decimals.

■ Parameter names are case sensitive.

■ You can use single or double quotes. If you are using double quotes, you need to enter "" for Revit Architecture to understand it as double quotes.

■ Valid unit types are length, area, volume, angle, force, and linear force.

■ Valid units: Valid units and suffixes:

■ For length: inches ("), feet ('), millimeters (mm), centimeters (cm), or meters (m).

■ For area: square_feet (SF), square_inches (in2), square_meters (m2), square_centimeters (cm2), square_millimeters (mm2), acres, or hectares.

■ For volume: cubic_yards (CY), cubic_feet (CF), cubic_inches (in3), cubic_centimeters (cm3),

cubic_millimeters (mm3), liters (L), gallons (gal).

■ For angle: decimal_degrees (°), minutes ('), seconds (").

■ For force: newtons (N), decanewtons (daN), kilonewtons (kN), meganewtons (MN), kips (kip),

kilograms_force (kgf), tonnes_force (Tf), and pounds (P).

■ For linear force: newtons_per_meter (N/m), decanewtons_per_meter (dan/m), kilonewtons_per_meter (kN/m), meganewtons_per_meter (MN/m), kips_per_foot (kip/ft), kilograms_force_per_meter (kgf/m), tonnes_force_per_meter (Tf/m), pounds_per_foot (P/ft).

■ You can enter a value for parameters of type Family Type. To declare the Family Type parameter in the parameter declaration, you would enter column-name##other##. The column name is the same as the Family Type parameter name. In the type catalog file, enter values as Family Name : Family Type. Be sure there are spaces before and after the colon. So for a family file called Chair-Executive.rfa with a type called Big Boss, you would enter Chair-Executive : Big Boss. If the family file has only one type, and it is the same name as the family, you do not need to include the Family Name.

■ Revit Architecture applies project unit settings to type catalogs when loading a family.