TestFit Documentation


Test Fit 101

The TestFit Workflow

Our recommended workflow:

  1. Load up context imagery using the underlay panel
  2. Define the site
  3. Adjust parameters to fit with this site
  4. Place parking (if it needs parking)
  5. Find a good starting option (if there are options available)
  6. Manually adjust the generated geometry to a more context-driven design
  7. Export this scheme to PDF, DXF, SKP, or CSV to do further analysis or refinement.

Watch Test Fit 101 to see this workflow in action.

Test Fit is intended to work top-left to bottom-left and then from left-to right. Inputs are always on the left. Outputs are always on the right.

The TestFit Workspace:

  1. Top Bar
    1. Reset – Resets the workspace to default values
    2. Load – Load existing .rsd Test Fit files
    3. Save – Launches a windows explorer box to save the following filetypes
      1. .rsd Test Fit files
      2. .pdf Portable Document Format -> The existing model will be saved out to floor plans on an 8.5×11 to the nearest engineering scale.
      3. .dxf Drawing Exchange Format -> The existing typical floor plans will be saved out to a layered DXF to an engineering scale of 1:1 where 1 is equal to 1 foot
      4. .skp Sketchup -> The existing massing model from 3D view will be saved to a sketchup file. Each floor plate will be a component
      5. .CSV Comma Separated Values -> The existing tabular data will be saved out to a .CSV (for import into excel)
    4. About – Links to documentation, release logs, and the current version
    5. Settings – Launches a window with the following on/off toggles:
      1. Trackpad Mode -> When enabled the right mouse click+drag will pan the model
      2. Show Building Section
      3. Show Default Presets
      4. Use Light Theme
    6. Feedback – Launches a window that will allow users to send our team any kind of feedback
  2. Underlay Panel – In order to use the underlay feature, there must not be any generated geometry. Erase all geometry first, then an underlay may be imported.
    1. Opacity Slider -> Slide left to right to lower and raise the opacity of underlaid reference material
    2. Aerial Toggle -> Toggles aerial map imagery
      1. Address Bar -> Use to search for an existing address
    3. Map Toggle -> Toggles road map imagery
      1. Address Bar -> Use to search for an existing address
    4. Image Toggle -> Toggles user-submitted imagery
      1. File Button -> Opens windows explorer to select an image for import (.png, .jpg, .gif, .jpeg, .bmp)
      2. Test Fit Image Loader -> Draw a line of known length to set the image’s scale (the longest known dimension is best practice) & Type that length into the text box & hit enter or “ok”
  3. Presets Panel – This panel is intended for users to save sets of parameters, rather than needing to manually create new presets every time a new site is test-fitted
    1. Default Presets
      1. Wrap – Typical wrap parameters (Building mass will “wrap” the parking deck)
      2. Podium – Typical podium parameters (Building mas will be placed only above the parking deck)
      3. Unparked – No parking is being considered (Building mass will use our mass placement algorithm and be placed if the solver can solve the site plan.
    2. User-Created Presets – These presets will sort alphabetically left-to-right, and top-to-bottom
      1. <name> – Create a custom name for this preset
      2. Save Button -> Saves all existing parameters to this preset
      3. Remove Button -> Removes a saved preset
    3. Removing the default presets -> Settings Panel -> Disable “show default presets”
  4. Input Panel
    1. Site
      1. Define Button -> Launches define site tool
      2. Global Setback -> Sets the global setback distance from the defined site line
      3. Tolerance -> Sets an invisible setback an additional amount of defined distance
        Video Player
    2. Building
      1. Building Mass Width -> Sets the building mass width
      2. Corridor Width -> Sets the corridor width
      3. Wrap Levels -> Sets the number of building levels wrapping a garage OR unparked levels
      4. Podium Levels -> Sets the number of building levels above the parking garage
      5. Line Garage -> If enabled podium buildings will have liner units, wrap buildings will force-wrap the garage (if not dimensionally constrained), and garage placement will be affected while defining the garage.
      6. Floor to Floor Height -> Set the global floor to floor height (affects facade takeoffs and courtyard aspect ratio)
      7. Common Area Toggle -> Must have the following disabled to toggle off common space: Fire Walls, Stairs, Units, and Spaces
      8. Efficiency -> Efficiency will be driven by this number rather than calculated. Must have the following disabled to use a user-given efficiency: Fire Walls, Stairs, Units, and Spaces
    3. Spaces
      1. Name -> Sets the name of the space
      2. Level -> Sets the level of the space
      3. Area -> Sets the target area of the space
      4. Reset Anchor Location Button -> Resets to the default space location
      5. Remove -> Removes this space
      6. Add -> Adds an additional space
    4. Balconies
      1. Width -> Sets the width of most balconies and the target area for inside corner balconies
      2. Depth -> Sets the depth of most balconies and the target area for inside corner balconies
      3. Depth Into Setback -> Sets the distance allowed to place a balcony into a setback
      4. Count as NRSF toggle -> Counts the balcony areas as NRSF for their unit
    5. Units
      1. Weight – Sets the target weight of this unit category
      2. Unit Average – Sets the target unit average size for this unit categroy
      3. Parking Ratio – Sets the target parking demand (in stalls) per unit in this caregory
      4. S – Studio category consists of units with no bedrooms and one living space
      5. A – One Bedroom Category – consists of units with one bedroom and one living space
      6. B – Two Bedroom Category – Consists of units with two bedrooms and one living space
      7. C – Three Bedroom Category – Consists of units with three bedrooms and one living space
      8. % Button – Converts weights to percentages
    6. Stairs
      1. Fire Wall Toggle – Enable or disable fire walls – Helpful if creating a Type I building or similar
      2. Building Area – Sets the maximum building area
      3. Max Dead End – Sets the maximum dead end distance for stairs (minimum currently set to 40′; 20′ minimum will not be supported until Test Fit rolls out Dead End Corridor Solving)
      4. Max Travel Distance – Sets the maximum travel distance between stairs
      5. Width -> Sets the width of the staircase
      6. Depth -> Sets the depth of the staircase
    7. Garage
      1. Define Button -> If a property line is defined a garage may be placed within it’s bounds given the following criteria:
        1. The current garage parameter set will allow for a garage smaller than the existing site size
        2. The cursor location places the garage in a valid location that will not violate a setback or property line
        3. The garage will be placed in an area as defined by the arrows and guides. Growth direction will be shown during the placement process
      2. Enable Garage Button -> Disable to have an un-parked site plan
      3. Rotate Garage Button -> Change garage orientation 90 degrees (also right click while in define garage mode)
      4. Tray Width -> Adjust the tray width
      5. Tray Count -> Adjust the number of trays
      6. Minimum Length -> Sometimes the garage does not need to grow, but cannot shrink due to internal ramping. This parameter sets a minimum garage dimension
      7. Padding -> An added amount of garage dimension around the perimeter of the garage
      8. Stall Average -> Defines the average area (in sq. ft or meters) per parking stall
      9. Stall Depth -> Defines stall depth, but only affects how the garage grows
      10. Stall Width -> Defines stall width, but only affects how the garage grows
      11. Levels Above Grade -> Defines the levels above grade for this garage
      12. Levels Below Grade -> Defines the levels below grade for this garage
  5. Navigation Panel
    1. Level -> Allows the level of the building in model view to be changed up or down
    2. Option -> If different automatically generated test fits are available, this will allow users to cycle through them
    3. Solve Button -> If a test fit successfully is generated, this will turn green and display “success”
      1. If an unsolved site plan is loaded with enough information to solve, click this button
      2. Most of the time a test fit will solve on its own, if it cannot solve, then the solve button can be pressed to re-solve the test fit.
      3. If it fails to solve, then there was an error in the solver and no solutions can be shown. Adjust any parameter and try again.
      4. If no model information is present, clicking the solve button will generate random geometry
  6. Output Panel – This panel shows a quantity takeoff of what is shown by the model
    1. Expand Tabulation Button -> Expands tabular data to show all takeoffs currently done by Test Fit
  7. Model View
    1. Pan the View -> click and drag middle mouse wheel (changes to right mouse button in trackpad mode)
    2. Zoom the View -> scroll middle mouse wheel
    3. Measuring Stick Button -> Toggles Line Measurement Tool (click one point and a second point to get a measurement)
    4. 3D Cube Buton -> Toggle 3D Massing view
      • While in 3D view use the middle mouse wheel to orbit, flick the middle mouse wheel to spin the model automatically
    5. M Button -> Toggles Manual Adjustment Mode
      1. This mode converts generated geometry into adjustable geometry
      2. Test Fit will no longer automatically model and adjust the following features:
        1. Garage Sizing
        2. Building Mass Placement
        3. Courtyard Aspect Ratio
      3. Building Button Toggled – Adjust building mass
        1. Left Click Drag on Empty Areas -> Creates new geometry
        2. Left Click Drag within Orange Circle -> Moves the intersection “node”
        3. Left Click Drag within White Circle and without Orange Circle -> Create building mass hosted on this “node”
        4. Right Click on Building Mass -> Delete building mass
        5. Right Click on Intersection “node” -> Delete all associated geometry
        6. On hover guidelines assist in placing building mass, given context (Site definition line and garage)
      4. Garage Button Toggled – Adjust parking garage
        1. Center Orange Circle -> Left Click Drag to move parking garage
        2. Corner Orange Circle -> Left Click Drag to rotate the parking garage
        3. Edge Orange Circle -> Left Click Drag to grow garage by tray count OR length depending on orientation
    6. Right Angle Button
      • Snaps site definition lines to the nearest 15th degree (0 degrees, 15 degree, 30 degrees…) relative to the model view.
    7. Arrows Button
      • Zoom model view to existing geometry
    8. Site Definition Lines
      1. Intersection Circles -> Left click drag to move ; Right click to delete (if there are more than three segments)
      2. Midpoint Circles -> Left click to create more segments
      3. Setback Circles -> Left click drag to set a local setback dimension
    9. Spaces Grip
      1. Left Click Drag the white circle within a “Space” to move the entire space in plan

Any Questions?