Functions Menu

Owned by Former user (Deleted)
Last updated: Oct 18, 2016
14 min read

Short Description

There are additional specialised features available for voyage charter calculations/estimates, in the Functions menu, such as sensitivity analysis, intake calculation, deviation calculation, etc., all aimed at increasing effectiveness and accuracy and providing options. 


Location:  Modules > Voyage Estimate > Functions Menu.

Chapters:

Long Description 

Sensitivity Analysis

Sensitivity Analysis can be defined as a method used to determine how a particular scenario may be affected by different values of an independent variable.The Sensitivity Analysis function enables an analysis to be run on the freight rate of a voyage charter calculation. When run, a list of freight rate variables will display, each line represents the freight rate +/- the entered variance. The result columns show the gross revenue, contribution and the TC Equivalent per freight rate. It also shows what impact of an additional day at sea, an additional day in port and the impact of one day less in port will have on the TC Equivalent for each freight rate. A sensitivity analysis can only be run on one cargo at a time and has no direct impact on the voyage calculation.

Run a Sensitivity Analysis

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open the voyage charter calculation with the freight rate to perform the sensitivity analysis on. Its fields will display.
  3. In the Cargoes field click the cargo on whose freight rate a sensitivity analysis is to be run - it will highlight.
  4. Go to the Functions menu and from the drop-down select Sensitivity. 




  5. The Sensitivity Analysis dialogue box opens. Each line represents the freight rate +/- the variance.




  6. Enter applicable variable under Variance.
  7. Click Recalculate. The new refreshed and recalculated results display.
  8. Modify the variable and recalculate as applicable.
  9. Click Print to print a copy of the run analysis if applicable
  10. Click Close. The dialogue box will close, but the run analysis will have no automatic impact on the voyage calculation.

Intake Calculation

The Intake Calculation function purpose is to calculate how much cargo can be loaded onto a vessel, once relevant parameters, for example draft restrictions, immersion, bunker reduction, water density, stowage restrictions, etc. have been deducted. Draft and stowage restrictions are calculated on retrieved (from for example the Vessel Administration module and the voyage calculation) and entered data. Draft restrictions differ depending on for example port draft, vessel draft and type of water. Stowage restrictions of a particular cargo are calculated based on the Stowage Factor (SF) of the type of cargo (or commodity) and can directly impact on the maximum quantity of a commodity a vessel can load. The Stowage Factor varies from one commodity to another and indicates how many cubic metres (m3) (or cubic feet, Ft3) of space one metric tonne of a particular cargo (or commodity) occupies in a hold of a vessel. The Quantity restriction of a vessel is the limit of a vessel’s maximum hold capacity in terms of volume (without reductions). The Intake Calculation function also allows for the calculation of maximum load capacity for cargo in terms of volume (i.e. maximum hold capacity deducted by relevant reductions).

The intake calculation result can be directly applied to the voyage calculation. Dataloy VMS will by default choose the lowest of available for load capacity (volume) figures under the Available for Cargo column and enter it under Quantity in the voyage calculation (i.e. maximum quantity a vessel can load during a voyage). Note: Option should NOT be used if the quantity figure under Quantity is LOWER than the lowest Available for Cargo figure. In such case, the figures of the stowage factor and/or quantity fields apply. In the Intake Calculation field the RoB FO, RoB DO, Stowage Factor (SF) and Quantity fields are directly linked to corresponding fields in the voyage calculation and will automatically update and recalculate if changed in the Intake Calculation dialogue box.

Run an Intake Calculation

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open the voyage charter calculation to run an intake calculation on. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Intake Calculation.


     
  4. The Intake Calculation dialogue box opens. 

    Example:



  5. The Intake Calculation dialogue box is divided into two panels, upper and lower.

    1. IMPORTANT: Upon entry of new figures in editable fields - press Enter to apply and recalculate.

      1. In the upper panel, fill in the fields as follows (where applicable - read-only fields self-populate):
      2. The vessel deadweight (DWT), draft and immersion data fields for varying conditions (Summer, Winter, Tropical) will automatically populate with data retrieved from the Vessel Administration module. 
        Note: DWT: the amount of weight a vessel can carry under varying conditions. Vessel draft: the distance from waterline to keel. Immersion: indicates vessel drop in inches (or centimetres) per metric tonne (MT) loaded onto vessel. The fields are always disabled from editing and in read-only format. They can ONLY be edited from the Vessel Administration module.
      3. Enter deadweight measurement (as applicable) under DWT. 
        Note: Defaults to metric tonnes (MT). The draft and immersion measurements are disabled from editing and retrieved data retrieved from the Vessel Administration module. Draft measurement is in metres (M) or feet (Ft), immersion measurement in tonnes per inch (TPI) (or centimetres (TPC)). 
      4. Enter the fuel oil (FO) remaining on board at voyage start date (leaving ballast port) under RoB FO (Remain on Board Fuel Oil).
        Note: Will automatically populate with data entered in the voyage calculation under corresponding field. Can be manually overridden. If so, corresponding fields in the voyage calculation will change and calculation update and recalculate as parameters changed.

      5. Enter the diesel oil (DO) remaining on board at voyage start date (leaving ballast port) under RoB DO (Remain on Board Diesel Oil).
        Note: Will automatically populate with data entered in the voyage calculation under corresponding field. Can be manually overridden. If so, corresponding fields in the voyage calculation will change and calculation update and recalculate as parameters changed. 

      6. Enter the stowage factor under SF (Stowage Factor).
        Note: Will automatically populate with data entered in the voyage calculation under corresponding field. Can be manually overridden. If so, corresponding fields in the voyage calculation will change and calculation update and recalculate as parameters changed.  
      7. Quantity displays the entered quantity of the voyage calculation.
        Note: Always disabled from editing, can only be edited in the voyage calculation, but will automatically recalculate and update whenever parameters of the Intake Calculation dialogue box change (including corresponding field in the voyage calculation).
    2. In the lower panel the populated row fields for each port in entered voyage calculation port rotation can be manually overridden (except #, Reason for Call, Port Name, Bunker Reduction, Draft Reduction and Available for Cargo) - edit if applicable:
      1. List (#) field lists the number of port calls.
      2. Reason for Call lists the reason for port call in the port rotation.
        Note: Will be populated with elsewhere entered data. 
      3. Port Name lists the port call name.
        Note: Will be populated with elsewhere entered data. 
      4. Enter zone (summer, winter, tropical) under Zone.
        Note: Will be populated with elsewhere entered data. 
      5. Enter port draft under Draft.
        Note: Individual port drafts are not predefined in Dataloy VMS. By default, Dataloy VMS equates vessel draft (distance from waterline to keel) with port draft (distance between waterline and sea/river/lake bed/floor). Must be manually changed - system will recalculate.
      6. Enter draft measurement (metre or feet) under Draft Measurement.
      7. Enter the water type code (in terms of salinity) under Water Salinity.
        Note: Fresh Water (FW), Salt Water (SW), Brackish Water (BW). Will be populated with elsewhere entered data. 
      8. Enter the water density under Water Density.
        Note: Automatically self-populates with water salinity predefined water density figure once water salinity type is entered.
      9. Enter applicable safety margin (in per cent) to be added to bunker usage amount between ports under Safety Margin.
      10. Bunker Reduction displays the reduced fuel level from ballast port to first port call and then from port to port.
        Note: Calculated on elsewhere entered parameters, for example distance between port calls, vessel speed and operation, etc.
      11. Draft Reduction displays the calculated amount that must be removed (if any) to keep vessel from running aground.
        Note: Draft Reduction is calculated based on port draft, vessel draft and vessel immersion. 
      12. Enter the constant extra weight added to vessel (such as supplies, crew, etc.) under Constant Reduction.
        Note: Will be populated with elsewhere entered data.
      13. Enter the amount of fresh water on board vessel under Fresh Water Reduction.
        Note: Will be populated with elsewhere entered data.
      14. Available for Cargo displays the maximum load capacity for cargo of a vessel in terms of VOLUME (i.e. maximum hold capacity deducted by the data of Steps 5b iv-xiii).
  6. Click Print to print a copy of the run calculation (if applicable).
  7. Click Apply to apply intake calculation result to voyage calculation. Dataloy VMS will by default choose the lowest of available for load capacity (volume) figures under the Available for Cargo column and enter under Quantity in the voyage calculation (i.e. maximum quantity a vessel can load during a voyage). The dialogue box will close.
    Note: DO NOT use Apply function if the quantity figure under Quantity is LOWER than the lowest Available for Cargo figure, for example due to stowage factor restriction applying to loading capacity of the vessel. If so, the Available for Cargo column figures do not apply and the Apply function will ONLY select from this column.
  8. Click Close. The dialogue box will close, but the run analysis will have no impact on the voyage calculation (except for any changes made in the upper panel).
  9. Click Apply to apply intake calculation result to voyage calculation. Dataloy VMS will by default choose the lowest of available for load capacity (volume) figures under the Available for Cargo column and enter under Quantity in the voyage calculation (i.e. maximum quantity a vessel can load during a voyage). The dialogue box will close.
    Note: DO NOT use Apply function if the quantity figure under Quantity is LOWER than the lowest Available for Cargo figure, for example due to stowage factor restriction applying to loading capacity of the vessel. If so, the Available for Cargo column figures do not apply and the Apply function will ONLY select from this column.  
  10. Click Close. The dialogue box will close, but the run analysis will have no impact on the voyage calculation (except for any changes made in the upper panel).

Top

Round Voyage Calculation

The Round Voyage function enables the combination of multiple voyage estimates (unlimited number) to arrive at a total result. Note: The function is only suitable for single cargo voyage charter calculations.

Create a Round Voyage Calculation

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open the voyage charter calculation to create a round voyage calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Round Voyage Calculation.


     
  4. The Cargo Ports field is replaced with the Round Voyages and Voyages Included fields.

    Example:


     
  5. In the Round Voyages field:
    Note: The Round Voyage lists all created round voyages (can be filtered). If no previous round voyage has been made - the view will be empty. 
    1. Click Create. 
    2. The Round Voyage Description pop-up opens.



    3. Enter the voyage name/description under Please input a round voyage description.
    4. Click OK. The pop-up will close and the newly created round voyage will appear as a row in the Round Voyages field (also states the round voyage creator). If the new round voyage is the first entered, Dataloy VMS automatically adds to the Voyages Included field the currently displayed voyage calculation as the first voyage.

      Example:


       
  6. In the Voyages Included field:
    Note: Displays in read-only format.
    1. Either 
      1. add an additional estimate:
        1. Click Add.  A pop-up with a list of previously entered voyage calculations opens. 
          Note: Displays by default only a user's own calculations. Can be filtered to display all previous calculations. Only SINGLE cargo calculations are suitable for round voyage calculations.

          Example:


           

      2. Filter (if applicable) to locate the voyage to be added to the round voyage.

      3. Double-click the voyage to be added. 

      4. The pop-up will close and the selected voyage estimate added to the round voyage as a row in the Voyages Included field.
        Note: All added estimates in the Voyages Included field are numbered sequentially (in the order they are added).

    2. or add the currently displayed estimate:
      1. Click Add Current. 
      2. The currently displayed voyage calculation will appear as a row in the Voyages Included field.
    3. or replace an existing included voyage with another:
      1. Click the included voyage to be replaced - it will highlight.
      2. Click Replace. A pop-up with a list of previously entered voyage calculations will open. 
        Note: Displays by default only a user's own calculations. Can be filtered to display all previous calculations. Only SINGLE cargo calculations are suitable for round voyage calculations.
      3. Double-click the voyage to replace the selected included voyage.
      4. The pop-up will close and the selected voyage will replace the selected included voyage.
  7. Repeat Step 6 as applicable until all voyages estimates to be included in the round voyage have been entered.
     
  8. In the Round Voyages field click Calculate.
  9. The Round Voyage Calculation and Sensitivity dialogue box will open and is divided into two panels, upper and lower. The upper panel displays the total number of days, contribution and TC Equivalent for the complete round voyage and provides the possibility to run a combined sensitivity analysis for two voyages of the round voyage, (at a time, any combination). The lower panel lists all voyages of the selected round voyage.
    1. To run a combined sensitivity analysis:

      1. In the upper panel: 

        1. Enter the variable for the matrix across axis (y-axis) under Var. Across (Variable Across).
        2. Enter the variable for the matrix down axis (x-axis) under Var. Down (Variable Down).
        3. Enter either
          1. the sequence number of the voyage with the freight rate to be displayed across the sensitivity matrix under Seq. Across (Sequence Across). 
          2. or in the lower panel:
            1. Click the voyage with the freight rate to be displayed across the sensitivity matrix - it will highlight.
            2. Click Set Voyage Across. The selected voyage's sequence number will display in the upper panel under Seq. Across.
        4. Enter either
          1. the sequence number of the voyage with the freight rate to be displayed down the sensitivity matrix under Seq. Down (Sequence Down).
          2. or in the lower panel:
            1. Click the voyage with the freight rate to be displayed down the sensitivity matrix - it will highlight.
            2. Click Set Voyage Down. The selected voyage's sequence number will display in the upper panel under Seq. Down.
        5. Click Calculate. The new refreshed and recalculated results will display in the sensitivity matrix.
        6. Modify the variables and recalculate as applicable.
      2. Click Print to print a copy of the run analysis/es (if applicable).
      3. Click Close. The dialogue box will close, but the run analysis will have no automatic impact on the voyage calculation.
  10. To revert to default layout - go to the Functions menu and from the drop-down select Round Voyage Calculation. 
  11.  The Round Voyages and Voyages Included fields will revert to the Cargo Ports field.


Remove a Round Voyage

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open a voyage charter calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Round Voyage Calculation.


     
  4. The Cargo Ports field is replaced with the Round Voyages (listing all entered round voyages) and Voyages Included (listing all partaking estimates/round voyage) fields.
  5. In the Round Voyages field, click the round voyage to be deleted - it will highlight and the estimates included in the round voyage display in the Voyages Included field.
  6. In the Voyages Included field, delete all voyages of the round voyage by following the step-by-step instructions of To remove an included voyage below.
  7. In the Round Voyages field, click Remove.


     
  8. A pop-up opens asking to confirm deletion.
  9. Click Yes. The pop-up will close and the selected round voyage deleted.
 

Open/Edit an Included Voyage

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open a voyage charter calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Round Voyage Calculation.


     
  4. The Cargo Ports field is replaced with the Round Voyages (listing all entered round voyages) and Voyages Included (listing all partaking estimates/round voyage) fields.
  5. In the Round Voyages field, click the round voyage with the included voyage to be opened/edited - it will highlight and the estimates included in the round voyage display in the Voyages Included field.
  6. In the Voyages Included field, click the included voyage to be open/edited - it will highlight.
  7. Click Open/Edit. The estimate opens in the voyage estimation browser.


     
  8. Edit as applicable. All changes automatically apply and auto-save.

Remove an Included Voyage

 
  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open a voyage charter calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Round Voyage Calculation.


     
  4. The Cargo Ports field is replaced with the Round Voyages (listing all entered round voyages) and Voyages Included (listing all partaking estimates/round voyage) fields.
  5. In the Round Voyages field, click the round voyage with the included voyage to be deleted - it will highlight and the estimates included in the round voyage display in the Voyages Included field.
  6. In the Voyages Included field, click the included voyage to be deleted - it will highlight.
  7.  Click Remove. A pop-up opens asking to confirm deletion.


     
  8. Click Yes. The pop-up will close and selected round voyage delete.

Top 

Deviation Calculation

The Deviation Calculation function displays the difference between a vessel going directly from initial to final port (direct voyage) and when including the port calls. The calculation displays miles, days at sea, days in port, canal days and the total day deviation. The calculation also displays the figures of the direct voyage and the fully loaded voyage following the port rotation. In the lower part of the calculation dialogue box, the fuel oil (FO) and diesel oil (DO) costs and the TC Equivalent for the deviation are displayed. The purpose is to establish the financial value to deviate to the additional ports rather than proceeding directly to voyage end port. A deviation calculation can only be run on ONE calculation at a time and it has no direct impact on the voyage calculation it is run on.


Open/Edit an Included Voyage

  1. Go to Modules > Voyage Estimate. The Voyage Estimate window will open.
  2. Open the voyage charter calculation to run a deviation calculation on. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Deviation Calculation.



  4. The Deviation Calculation dialogue box opens displaying a deviation calculation for the open voyage charter estimate.


     
  5. Click Print to print a copy of the run calculation (if applicable).
  6. Click Close. The dialogue box will close. The run calculation will have no impact on the voyage calculation.

Top

Similar Tonnage

The Similar Tonnage function allows for the calculation of the contribution and TC Equivalent for a particular voyage using different vessels. For estimates ONLY. 

 
Perform a Reverse Calculation
 
  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open a voyage charter calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Similar Tonnage.


     
  4. The Similar Tonnage dialogue box displays.
    Note: The Reverse Calculate TCE option is currently NOT IN USE. 



  5. Click Add Vessel.
  6. The Select a Vessel pop-up with a list of input values opens. Select applicable vessel and click OK.



  7. The pop-up will close and the added vessel display as a row in the Similar Tonnage dialogue box.
    Note: The added vessel row only displays the vessel name. All other fields will be blank. 
  8. Repeat Steps 5-6 (as applicable) until all vessels to run reverse calculations on have been added.
  9. Click Recalculate. The calculated contribution and TC Equivalent for all listed vessel will display respectively. 
  10. Click Close. The dialogue box will close, but the run analysis will have no automatic impact on the voyage calculation.
 

Delete a Vessel from the Reverse Calculation

 
  1. Go to Modules > Voyage Estimate. The Voyage Estimate window will open.
  2. Open a voyage charter calculation. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Similar Tonnage.


     
  4. The Similar Tonnage dialogue box will display.
  5. Click the vessel row to be deleted - it will highlight.
  6. Click Remove Vessel. The vessel row will delete.

     

  Schedule

The Schedule function displays the entered port rotation of a calculation graphically on a map in the Schedule dialogue box, including a separate list of route port calls (to visit and have visited) and the approximate time of arrival and departure of each. Different colours highlight days in the Voyage Calendar when in port (green) or at sea (blue). If, at any time, changes are made to the voyage rotation in the voyage calculation, the map will update. It is possible to change the voyage start date directly from the Schedule function.

Change Voyage Start Date from the Schedule Function

  1. Enter the new voyage start date under Voyage Start Date (location: above map).
    Note: Enter new date as: DDMMYYTIME, for example write the date 12 December 2013, 12.00 a.m. as: 1212131200.
  2. Click Update. The estimate (and schedule function) recalculates and updates.

    Example:


     

Parcel Functions: Contribution Analysis

The Contribution Analysis option is for multiple cargoes and analyses how much each cargo contributes to the voyage, i.e. the impact on the increase/decrease of the TC Equivalent if a cargo is added/removed. 


Perform a reverse calculation
 
  1. Go to Modules > Voyage Estimate. The Voyage Estimate window opens.
  2. Open the voyage charter calculation with the cargoes to run a contribution analysis on. Its fields will display.
  3. Go to the Functions menu and from the drop-down select Parcel Functions > Contribution Analysis.


     
  4. The Contribution Analysis dialogue box will open and all cargoes of the voyage estimate will be listed, displaying the the effect of adding/removing a cargo to/from a vessel by the increase/decrease of days, DO and FO costs, port cost, contribution, TC Equivalent and running cost.
    Note: The Create New and Remove options are currently NOT IN USE. 



  5. Click Close. The dialogue box will close. The run analysis will have no automatic impact on the voyage calculation. 

Parcel Functions: Absorption Analysis

The Absorption Analysis function calculates a result per day, per metric tonne (MT) and per cubic unit for each result of the cargoes of a voyage calculation. The direct cost and revenues for each cargo are directly attributed to the cargo while other cost elements, for example bunkers, port cost, time, miscellaneous, etc. are distributed to each cargo (either by weight or cubic size), for example, the port cost for a load port would be distributed to each cargo loading in the port based on their relative portion of the total quantity. The Absorption Analysis function is useful when running large amounts of cargoes in break bulk, steel, chemicals or other types of parcelled cargo.

Top
Back

Related Content

 Expand to see related content

Unknown macro: {dynamiccontentbylabel}