Skip to content

Latest commit

 

History

History
57 lines (39 loc) · 3.52 KB

README.md

File metadata and controls

57 lines (39 loc) · 3.52 KB
Raw

TuneUp

Build

TuneUp is in beta.

TuneUp is a view extension for analyzing the performance of Dynamo graphs. TuneUp allows you to see overall graph execution time, per-node execution time, and other helpful information about what's happening under the hood, e.g. nodes run in the current execution v.s. nodes run in the previous execution (which were skipped during the most recent graph run for optimization/ caching).

Here is a short demo of how to utilize it as of now (now loading from the Extensions menu): TuneUp

Here is a mock up of the future design: TuneUp

Building

Recommended Build Environment

  • VisualStudio 2022 or later
  • .NET 8.0 Developer Pack
  • Dynamo repository cloned and built on the same level of TuneUp repository which means your Dynamo repo and TuneUp repo should exist under the same parent folder.

Result Binaries

  • After a Debug build of Tuneup one can expect:
    • Under TuneUp\dist\TuneUp, there is a sample package wrapped up ready for publishing and adoption. This would be the un-optimized version.
    • Un-optimized package installed locally for [DynamoVersion] defined in TuneUp/TuneUp.csproj, under DynamoCore and DynamoRevit
  • After a Release build of Tuneup one can expect: Under TuneUp\dist\TuneUp, there is a sample package wrapped up ready for publishing and adoption. This would be the optimized version.

Known issues

  • TuneUp does not work with .dyfs (custom nodes) yet.
  • TuneUp binaries are not semantically versioned and are not intended to be built on top of as an API. Do not treat these binaries like DynamoCore.
  • TuneUp requires Dynamo 3.0 or higher for access to new extension APIs.
  • When user have TuneUp open, after switching workspace in Dynamo, the first graph run does not give execution time and nodes order.
  • Although it's not an issue by itself, TuneUp profiles the execution of graphs even if not showing on the extension bar.
  • In some cases TuneUp may calculate incorrect execution times for nodes, we cannot reproduce this consistently, if you see this occur and can reproduce it please file an issue!

Testing

Setup

Please check out known issues before trying to setup testing.

  • Download DynamoCoreRuntime 3.0.0 (or higher) from dynamobuilds.com. Alternatively, you can build Dynamo from Dynamo repository and use the bin folder equivalently.
  • Copy all contents of the DynamoCoreRuntime to TuneUp\TuneUpTests\bin\Debug\. If you are building Dynamo locally, copy all contents of Dynamo from Dynamo/bin/AnyCPU/Debug to TuneUp\TuneUpTests\bin\Debug\
  • Copy TuneUp_ViewExtensionDefinition.xml from TuneUp\TuneUp\manifests\ to TuneUp\TuneUpTests\bin\Debug\viewExtensions\
  • Open the copied TuneUp_ViewExtensionDefinition.xml and change the assemply path to ..\TuneUp.dll
  • Remove TuneUp from your Dynamo packages folder if you have it installed from package manager (otherwise TuneUp.dll will get loaded twice). This won't work well.
  • Launch DynamoSandbox.exe, then click View-> Open Tune Up and use while a graph runs.

Running TuneUp Unit Tests

  • Install NUnit3TestAdapter from VisualStudio->Extensions->Manage Extensions->Online.
  • Open Test Explorer from VisualStudio->Test->Test Explorer. Now you should see a list of TuneUpTests.
  • Click the target test to run or run them all.