CompHound project landing page
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

CompHound – Component Tracker

This is the CompHound project main landing page.

CompHound is a cloud-based universal component and asset usage analysis, reporting, bill of materials, visualisation and navigation project providing sample code for two presentations on connecting the desktop with the cloud at RTC Europe in Budapest end of October and Autodesk University in Las Vegas in December.

It currently consists of two parts:

This project is based on and derived from the node.js mongodb web server for the FireRating in the Cloud sample, consisting of the FireRatingCloud C# .NET REST API client Revit add-in and the fireratingdb Node.js mongoDB web server.

In addition to that, this project also sports a user interface, including report, bill of material, Autodesk View and Data API 2D and 3D model analysis, viewing and navigation functionality.

You can try it out live and read the detailed articles describing the entire project implementation and evolution below.

Try it out Live

You can explore this app up and running live.

Here is the mongolab-hosted database that we are using:

It contains the collection of component instances. The only occurrences that I exported so far are from the standard Revit sample file rst_advanced_sample_project.rvt. You can add more yourself by running the CompHoundRvt add-in in any other Revit BIM of your choice.

The node.js web server driving the database via mongoose is hosted on Heroku, and its URL is

Its REST API is accessible via the route /api/v1.

/api/v1/instances should in theory return all database entries, but it will fail with an application error due to too large data.

From version 0.0.25 onwards, the REST API route /api/v1/auth provides access to the View and Data API authorisation token.

However, you can use /api/v1/instances/:id to retrieve the JSON document for a single specific entry.

Finally, it sports the beginnings of a user interface that currently provides the following access points:

  • / – say hello.
  • /hello/:message – reply with the message passed in.
  • /html/count – return the number of database entries.
  • /www/instances1 – list all the database entries in a table – this can take a long time.
  • /datatable2 – display a datatable navigation interface through the instance records.

In the long run, most of these access points can be shut down again.

Instead, one single main index entry point will display the datatable listing the component occurrences as well as provide access to the still missing reporting, viewing and model navigation functionality.

Further Reading

The following discussions by The 3D Web Coder and The Building Coder describe the entire project implementation and evolution:


Jeremy Tammik, The Building Coder and The 3D Web Coder, ADN Open, Autodesk Inc.


This sample is licensed under the terms of the MIT License. Please see the LICENSE file for full details.