Welcome to the home of Krakatau Essential Project Manager
Measuring churn metrics, changed source lines of code & changed logical lines of code

 

Frequently Asked Questions

  • How do install the license to try the tool on my C# code?
  • Do I have to install MySQL to run EPM?
  • What if I have a MySQL server I wish to utilise?
  • Why do I get a MySQL error when running EPM repeatedly?
  • What is the format of an EPM filelist?
  • What do the metrics mean?
  • How are added, deleted and changed files and source lines calculated?
  • How do install the license to try the tool on my C# code? Top of FAQ

    After requesting a license from Powersoftware.com:

    • please detach the "license.dat" file from the email you receive
    • and save into the EPM install directory - by default C:\Program Files\Power Software\Essential Metrics PM (Csharp).
    • Run EPM again and it will accept the license.

    Do I have to install MySQL to run EPM? Top of FAQ

    No. MySQL is bundled with EPM. If you are not concerned about managing and querying a MySQL database, simply run the tool with no "-s" (MySQL server) parameter and it will start MySQL locally before running EPM.

    What if I have a MySQL server I wish to utilise? Top of FAQ

    If this case, specify the "-s" parameter, followed by the machinename of the server where MySQL is running. Suppose the machine were called "mysql1", you would include "-s mysql1" in your call to EPM and this would create your database on this server, and build metrics data there.

    Why do I get a MySQL error when running EPM repeatedly? Top of FAQ

    Each time you execute EPM, it starts a MySQL server process in order to store and report results.

    It takes a few hundreths of a second to close open files and stop the server process, and therefore you should pause a moment before re-running MySQL. In normal operation you would not see this error, only when testing the tool manually from the command line.

    This problem is also resolved by running a stand-alone MySQL server and pointing EPM to it using the "-s" parameter.

    What is the format of an EPM filelist? Top of FAQ

    • Line 1: Project Name
    • Line 2: Project Snapshot date (a text representation of the date snapshot taken)
    • Line 3: Base directory (useful for cropping long paths and essential for PM comparisons)
    • Line 4-end: full path and filename of each file

    What do the metrics mean? Top of FAQ

    Your tool seems to be working very well. I've been able to generate stats for big projects once I got the file list format right.

    I have an outstanding question, while I'm still testing it, if you don't mind:
    Is the exact meaning of all the metric codes documented somewhere? For instance, I suppose LOC in the tables means "lines of code" but what about SLOC? NSC?

    If you go to the EPM product page and click on the metrics acronym (shown in blue) you will get an explanation of each metric.

    Specifically:

    • SLOC is source lines of code (LOC minus comments and whitespace)
    • NSC is semi-colon lines of code sometimes called LLOC or logical lines of code.

    How are added, deleted and changed files and source lines calculated? Top of FAQ

    Added files are in the new project, but not in the old. Deleted files were in the old project but no longer in the new. Changed files exist in both but have Changed in some way (i.e. CHG_SLOC is greater than zero).

    ADD_SLOC, DEL_SLOC and CHG_SLOC are calculated using the standard Unix difference ("diff") algorithm. Please open and view this document for a full explanation of these calculations: http://www.powersoftware.com/pm/pm_chg_ex.pdf.

    Home
    Products
     
     
     Essential Metrics
     
     Essential PM
     Project Manager
     Professional
     Lite
     
     Visualize it!
    Online Documents
    Customers
    Download
    Contact
    Last Updated
    01 Feb 2015

    Copyright © 2015 PowerSoftware.com