Page Comparison

...

RU 🇷🇺

...

Table of Contents

Overview

Sometimes you need to map a Block Model field that isn't coded in the original block model. Custom variables allow us to write complex logic in a readable and reusable way, which can then be mixed with other inline formulas in the block model mappings.

Table of Contents

Creating a custom variable

Go to Setup > Block Model > Edit > Reservable Model Generator.
Click Custom Variables to open the script editor.
Clear all text from the code editor.
Replace it with the sample code below.

...

Dry Tonnes

...

language	c#

...

Block Model. For example, Ore and Waste definitions can be more complex and multiple grades and types inputs are required. In this case, to define different properties use Custom Variable functionality implemented through the Script Editor.

Scripting language is C#.

Inline formula vs Custom Variable

To define different properties you can write an inline formula using “IF” statement, such as If N(“Fe”) is greater than 60 return “hg” otherwise if N(“Fe”) is greater than 58 return “mg” otherwise if N(“Fe”) is greater than 57,5 return “lg1” otherwise if N(“Fe”) is greater than 56 return “lg2” otherwise if N(“Fe”) is greater than 50 return “minw” otherwise call it “waste”.

...

But such linear formulas can be too long and confusing. Therefore, if there are multiple properties and parcel types that need to be separated, it is recommended to use Custom Variables.

Custom variables allow us to write complex logic in a readable and reusable way, which can then be mixed with other inline formulas in the block model mappings.

...

Creating Custom Variable

Go to Setup > Block Model > Edit > Reservable Model Generator.
Click Custom Variables to open the Script Editor.
Clear all text from the Script Editor.
Replace it with one of the sample codes listed below.
In the list of available variables on the right you will see a new variable CustomT("Parcel") in bold, map it to the Parcel field.

...

Custom Variables Examples

Dry Tonnes

Code Block

language	c#

using System; 
using System.Collections.Generic; 
using System.Text; 
using System.Linq; 
using Alastri.Scripting; 
using Alastri.BlockModel.Engine.CustomVariables;

public class DryTonnes : IDoubleCustomVariable
{
    public double GetNumber(CustomVariablesContext context)
    {
        double density = context.N("DENSITY");

        double volume = context.N("XINC")*context.N("YINC")*context.N("ZINC");
        
        return (density > 0 ? density * volume : 0);
        
    }
}

Grade bins

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{
    public string GetText(CustomVariablesContext context)
    {
        double fe = context.N("fe");
        
        if(fe > 60)        return "hg";
        else if(fe > 58)   return "mg";
        else if(fe > 57.5) return "lg1";
        else if(fe > 56)   return "lg2"; 
        else if(fe > 50)   return "minw";
        else               return "w";

    }
}

Multiple Grade Bins

Code Block

language	c#

using System;
using System.Collections.Generic; 
using System.Text; 
using System.Linq; 
using Alastri.Scripting; 
using Alastri.BlockModel.Engine.CustomVariables;

public class DryTonnesParcel : IDoubleCustomVariableITextCustomVariable
{
    public doublestring GetNumberGetText(CustomVariablesContext context)
    {
        double densityfe = context.N("DENSITYfe");

        double volumeal = context.N("XINCal")*;
        string geology = context.NT("YINC")*context.N("ZINC")geology");
        
        string fe_bin;
        
        return if(densityfe > 0 ? density * volume : 0); 60) 
        {
             fe_bin = "60";
        }
        else }
}

Grade Bins

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{if(fe > 55) 
        {
            publicfe string= GetText(CustomVariablesContext context)
Math.Floor(fe); 
  {         double fe_bin = contextfe.NToString("fe#,##0");
        }
        if(feelse
> 60)       {
return "hg";         else if(fe > 58)   return_bin = "mg50";
        else if(fe >
57.5) return "lg1";      }

  else if(fe > 56)   return "lg2"; string al_bin;

       else if(feal >< 503)
    return "minw";   {
     else      al_bin = "3";
      return "w"; }
    }
}

Multiple Grade Bins

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{    else if(al < 6)
        {
        public string GetText(CustomVariablesContext context)al = Math.Ceiling(al);
  {         double feal_bin = contextal.NToString("fe#,##0");
        }
        doubleelse
al = context.N("al");      {
  string geology = context.T("geology");     al_bin = "9";
        }

string fe_bin;       string geoClass = "1";
        if(fe > 60) (geology.Equals("detrital", StringComparison.OrdinalIgnoreCase))
        {
             fe_bingeoClass = "602";
        }

        elsereturn if(fe_bin > 55) 
        {+ "_" + al_bin + "_" + geoClass;
            fe = Math.Floor(fe); 
            fe_bin = fe.ToString("#,##0");
        }
        else
        {
           fe_bin = "50";
        }

        string al_bin;

        if(al < 3)
        {
 }
}

Ore Ratio

Rapid Reserver block model fields cannot report Stripping Ratio, because Stripping Ratio is not a sum or weight average type field. Instead, we can report ore ratio, which is the weight average of ore tonnes over total tonnes.

To do this we can set up a weight-averaged field called OreRatio as a child of "dryTonnes" or "wetTonnes" (whichever you want to report). This field will report a "1" for ore and a "0" for waste. The weight average of the 1s and 0s across a blast becomes the ore ratio.

Ore Ratio code

Code Block

language	c#

using System; 
using System.Collections.Generic; 
using System.Text; 
using System.Linq; 
using Alastri.Scripting; 
using Alastri.BlockModel.Engine.CustomVariables;

public class OreRatio : IDoubleCustomVariable
{
    List<string> ores = new List<string>(){ "hg", "mg", "lg" }; //all lower case
     
   al_bin = "3";
 public double GetNumber(CustomVariablesContext context)
    {
 }       string matType else if(al < 6)
        {= context.T("mattype").ToLower(); //material type field from original block model

        bool isOre   al= ores.Any(ore => MathmatType.CeilStartsWith(alore)); 
        
      al_bin = al.ToString("#,##0") if(isOre) return 1;
        }else return 0;
    }
 else
        {
          al_bin = "9";
        }

        string geoClass = "1";}

Multiple Custom Variables

To create multiple custom variables, a class implementing the IDoubleCustomVariable or ITextCustomVariable interface needs to be created for each variable. These classes need to be listed under one another in the Custom Variables Script Editor, as shown in the examples below.

Multiple Custom Variables

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{
    public string GetText(CustomVariablesContext context)
    {
        double fe = if(geologycontext.EqualsN("detritalfe", StringComparison.OrdinalIgnoreCase))
);
       { 
          geoClass = "2";
        }if(fe > 60)        return "hg";
 return fe_bin + "_" + al_bin + "_" + geoClass;
else if(fe > 58)    }
}

Ore Ratio

Rapid Reserver block model fields cannot report Stripping Ratio, because Stripping Ratio is not a sum or weight average type field. Instead, we can report ore ratio, which is the weight average of ore tonnes over total tonnes.

To do this we can set up a weight-averaged field called OreRatio as a child of "dryTonnes" or "wetTonnes" (whichever you want to report). This field will report a "1" for ore and a "0" for waste. The weight average of the 1s and 0s across a blast becomes the ore ratio.

Ore Ratio

Code Block

language	c#

using System; 
using System.Collections.Generic; 
using System.Text; 
using System.Linq; 
using Alastri.Scripting; 
using Alastri.BlockModel.Engine.CustomVariables;

public class OreRatio : IDoubleCustomVariable
{
    List<string> ores = new List<string>(){ "hg", "mg", "lg" }; //all lower case
     
    public double GetNumber(CustomVariablesContext context)
    {return "mg";
        else if(fe > 57.5) return "lg1";
        else if(fe > 56)   return "lg2"; 
        else if(fe > 50)   return "minw";
        else               return "w";
    }
}

public class DryTonnes : IDoubleCustomVariable
{
    public double GetNumber(CustomVariablesContext context)
    {
        double density = context.N("DENSITY");

        double volume = context.N("XINC")*context.N("YINC")*context.N("ZINC");
        
        return (density > 0 ? density * volume : 0);
        
     string matType = context.T("mattype").ToLower(); //material type field from original block model

        bool isOre = ores.Any(ore => matType.StartsWith(ore)); 
     }
}

Multiple variables with shared logic

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;
 
//block model 1 has a "parcel1" variable
public class Parcel1 : ITextCustomVariable
{
    public string GetText(CustomVariablesContext context)
   if(isOre) return{
1;        string elseparcel return 0;
    }
}

Multiple Custom Variables

To create multiple custom variables, a class implementing the IDoubleCustomVariable or ITextCustomVariable interface needs to be created for each variable. These classes need to be listed under one another in the Custom Variables Script Editor, as shown in the examples below.

Multiple Custom Variables

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel= context.T("mtype"); //block model 1 field
        return ParcelResolver.Parcel(parcel);
    }
}

//block model 2 has a "parcel2" variable
public class Parcel2 : ITextCustomVariable
{
    public string GetText(CustomVariablesContext context)
    {
        doublestring feparcel = context.NT("feioretype"); // block model 2 field
            if(fe > 60)return ParcelResolver.Parcel(parcel);
    }
}

//parcel logic return "hg";
        else if(fe > 58)   return "mg";
        else if(fe > 57.5) return "lg1";is wrapped up in the static ParcelResolver class
public static class ParcelResolver 
{
    private static List<string> _oreList = new List<string> 
    { 
       else if(fe > 56)   return "hg", "hg1", "bl1", "mg", "lg", "lg1", "lg2";, "mw"
    };
   else if(fe
> 50)   return "minw";
  public static string Parcel(string parcel) 
    else{
             if(_oreList.Contains(parcel.ToLower())) return "w";
    }
}

public class DryTonnes : IDoubleCustomVariable
{ore"; 
        publicelse double GetNumber(CustomVariablesContext context)return "waste";
     {
        double density = context.N("DENSITY");

        double volume = context.N("XINC")*context.N("YINC")*context.N("ZINC");
        
        return (density > 0 ? density * volume : 0);}
}

Access Custom Variable from another Custom Variable

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{
       public string GetText(CustomVariablesContext context)
       {
              double fe = context.N("fe");              
              if(fe >  }
}

Multiple variables with shared logic

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;
 
//block model 1 has a "parcel1" variable
public class Parcel1 : ITextCustomVariable
{
    public string GetText(CustomVariablesContext context)60) 
                 return "hg";
              else if(fe > 58) 
      {         string parcel =return context.T("mtypemg"); //block model 1 field
  ;
              else if(fe > 57.5) 
    return ParcelResolver.Parcel(parcel);     } }  //block model 2 has areturn "parcel2lg1";
variable  public  class  Parcel2  :  ITextCustomVariable  {  else if(fe >  public56) string
GetText(CustomVariablesContext context)     {         string parcel =return context.T("ioretypelg2");
  //  block  model  2  field    else if(fe > 50) 
  return ParcelResolver.Parcel(parcel);     } }  //parcel logic is wrapped up in the static ParcelResolver class
public static class ParcelResolver 
{
return "minw";
              else 
  private static List<string> _oreList = new List<string>      {   return "w";
       }
}
"hg", "hg1", "bl1", "mg", "lg", "lg1", "lg2", "mw"
    };
    
    public static string Parcel(string parcel) 
    {
        if(_oreList.Contains(parcel.ToLower())) return "ore"; 
        else return "waste";
    }
}

Access Custom Variable from another Custom Variable

Code Block

language	c#

using System;
using System.Collections.Generic;
using System.Text;
using System.Linq;
using Alastri.Scripting;
using Alastri.BlockModel.Engine.CustomVariables;

public class Parcel : ITextCustomVariable
{
public class Recovery : IDoubleCustomVariable
{
     public double GetNumber(CustomVariablesContext context)
     {
           Parcel parcel = new Parcel(); //Create an instance of the Parcel object
           string p = parcel.GetText(context); //Call the GetText() method, store the result in variable 'p'

           double volume = context.N("XINC")*context.N("YINC")*context.N("ZINC");

           if(p == "hglp" ) 
               return volume * 1.20;
         public  string else GetText(CustomVariablesContext context)if(p == "hg")
         {      return volume * 1.20;
          double else feif(p == context.N("femg");
               return volume * 1.20;
             if(fe > 60) 
                 return "hg"       else if(p == "lg1")
               return volume * 1.20;
              else else if(fep > 58) 
                 return "mg";== "lg2")
               return volume * 0.85;
           else 
               return 0;
      else}
if(fe > 57.5) 
                 return "lg1";
              else if(fe > 56) }

Access Custom Variable values from another Custom Variable

Code Block

// Reading Factors from one variable into a second variable
// Update the ROM Recon Factors below 

public class reconFactorVariable_1
{
       double fe_F  = 1.0; 
       double al_F     = 1.0;
  return "lg2";      
        else if(fe > 50)
    public double GetReconValue(CustomVariablesContext context, string code)
    {    return "minw";               else  
       if (code.Equals("fe_F",StringComparison.OrdinalIgnoreCase))
       return "w"fe_F;
       } }  public class Recovery : IDoubleCustomVariable
{
     public double GetNumber(CustomVariablesContext context)
     {
           Parcel parcel = new Parcel(); //Create an instance of the Parcel object
           string p = parcel.GetText(context); //Call the GetText() method, store the result in variable 'p'

           double volume = context.N("XINC")*context.N("YINC")*context.N("ZINC");

           if(p == "hglp" ) 
               return volume * 1.20;
           else if(p == "hg")
               return volume * 1.20;
           else if(p == "mg")
               return volume * 1.20;
           else if(p == "lg1")
               return volume * 1.20;
           else if(p == "lg2")
               return volume * 0.85;
           else 
               return 0;
      }
}
if (code.Equals("al_F",StringComparison.OrdinalIgnoreCase))
       return al_F;
       
       return 1;      
    } 
}


public class fe_R_Variable_2 : IDoubleCustomVariable
{
    public double GetNumber(CustomVariablesContext context)
    {
        var rf = new reconFactorVariable_1();
        double grade = context.N("i_fe");
        grade = grade * rf.GetReconValue(context,"fe_F");
        return grade;
    }
}

public class al_R_Variable_2 : IDoubleCustomVariable
{
    public double GetNumber(CustomVariablesContext context)
    {
        var rf = new reconFactorVariable_1();
        double grade = context.N("i_al");
        grade = grade * rf.GetReconValue(context,"al_F");
        return grade;
    }
}

Variable validation and Error list resolution

Check if the statement is correct by pressing the Compile button at the top left corner of the Script Editor.

...

If you did a mistake, the Compile Error window will pop up, showing row and column of an error with a short description of its type.

...

Read the error message description and correct the lines specified.

If there are no errors during compilation, the custom variables should be listed in the Variables panel.

...

Раздел документации на русском языке 🇷🇺 When the Errors panel is blank, and all relevant fields are mapped, press Generate to build the Reserve Model.

...

Versions Compared

Old Version 3

New Version Current

Key

Overview

Creating a custom variable

Inline formula vs Custom Variable

Creating Custom Variable

Custom Variables Examples

Dry Tonnes

Grade bins

Multiple Grade Bins

Ore Ratio

Ore Ratio code

Multiple Custom Variables

Multiple Custom Variables

Ore Ratio

Multiple variables with shared logic

Multiple Custom Variables

Access Custom Variable from another Custom Variable

Access Custom Variable values from another Custom Variable

Variable validation and Error list resolution