Skip to main content

Naming Conventions Alternatives

  • November 15, 2025
  • 1 reply
  • 48 views

Bill in North Carolina
Master Trendsetter
Forum|alt.badge.img+8

https://kb.pigment.com/docs/naming-convention-for-pigment

I believe readability is key when working with formulas in Pigment. I have a few recommendations for the naming conventions

1.) the prefixes should be in lowercase. UPPER case draws your eye to the prefix and that isn’t the key to the metric; it’s a supporting detail. I believe CALC_Gross Margin highlights the calc more than the Gross Margin

CALC_Gross Margin

vs.

calc_Gross Margin
 

2.) the prefix SET is misleading.If you step away from writing formulas for a while (a few weeks) and then come back, you have to remember SET is a setting and it isn’t an imperative /command. For instance SET_Load Actuals to me sounds like you want to change something. I would recommend using CFG (actually cfg to match my lowercase preference).

3.) the prefix REP is also not obvious to me; I would prefer RPT (again, rpt to match my lowercase preference) 

The good news is the bulk block renaming feature makes this pretty easy to implement

1 reply

  • November 17, 2025

I would be good to have a tagging mechanism instead of forcefully name the metrics with added noise like numbers and type conventions.

Though it is great to know about a metric being a cal, an input or an outgoing shared metric. Yet this is really useful for maintenance or auditing purposes. For everyday work, we just need the metric name close to a business concept (like turnover, price effet or irr)