Cargo Surveyor for iOS version 1.6.2 – Transfer executive summary report

This tutorial deals with the Transfer executive summary report.

In the previous tutorial we discussed the updated ullage report, and the different options that are available to us to tailor the ullage report to our specific requirements.

Today we will discuss the updated version (1.6.4) of the transfer executive summary report:

In the previous session concerning the ullage report we completed generating an ullage report using Extended Layout, and we discussed how to generate the ullage report with various options, send it by mail and export it to csv.

Once a cargo operation is completed, we can use the transfer executive summary utility to:

• Calculate cargo discharged or loaded (in the case of part discharge, and in case of loading multiple parcels)
• Calculate comparisons between ship received / shore supplied, or in case of STS operations mother / daughter discharged / received
• Calculate comparisons between Bill of lading figures and ship discharged, or Bill of lading figures and ship received

NOTE: an update to the app was published on Saturday (July 11th), fixing a bug that caused GSV and weights to show incorrectly under certain circumstances.

To get to the Transfer report editor we first need to go to the list of reports (‘Pdf/jpg Reports’), which can be accessed from the ‘More’ tab, press the ‘Reports’ button and then select ‘Txfer Reports’ from the list of available reports.

Select Txfer Reports from the list

This will bring you to the Transfer Summary Editor. A dialog is shown initially to let you choose between Standard and Extended Ullage reports for the summary:

Choose Extended or Standard Layout

For this exercise we will select Standard Layout. Once the selection is made, the dialog disappears, and you will see that the ‘View Summary’ and ‘View Pdf’ buttons are disabled. They will only be enabled once you have selected both an ullage report for before and after the operation.

Above the two buttons ‘View Summary’ and ‘View Pdf’ there is a switch for selecting whether the report is for the ship, or for the client; the difference is that if the report is ‘For Ship’, it will simply list the quantities before and after the operation and the total quantity loaded or discharged. If the report is ‘For Client’, aside from the quantities before and after the cargo operation, comparisons are shown between Bill of Lading and transferred quantity, and quantity transferred to or from terminal or other vessel (in case of STS). Also in case of STS, VEF corrected transferred quantities are calculated and shown.

In the older versions (pre 1.6.2) there was no option to insert a bill of lading date, and record the VEF for mother and daughter vessel in case of STS.

For each unit MTAir / MTVac / LTons etc you can choose whether the value should be printed or not. The setting ‘Apply VCF to totals only’ in general Settings applies here just like in ullage reports: if this is set to Yes, GSV will be calculated basis total net GOV corrected for average temperature instead of calculating GSV for each tank.

Inside the editor you can select the two ullage reports to use for producing the transfer report. When you press ‘Select’ next to the ‘Choose Before’ label, the list with available ullage reports will appear. You can select the one you want to use, choose whether you want to use the totals of all grades or one particular grade, and after that the name of that ullage report appears instead of the ‘Choose Before’ text. The same goes for the ‘Choose After’ selection:

Select grade or totals

‘Before’ report selected

‘After’ report selected

As you can see in the picture above, our two earlier generated ullage reports have been selected: ‘loaded’ and ‘after discharging’, and for each report the grade ‘Rmg’ has been selected. We could also have selected ‘Totals’ in this case since each report only contains one grade, but if the vessel were loading or discharging multiple grades then we would definitely have to select here the grade that we want to be calculated only.

Below the ‘For Ship’ switch there are two buttons:

– View Summary: when pressed, this will show the total quantity loaded or discharged, in a new window:

View Summary

– View Pdf: when pressed, this will generate the actual pdf (or jpg) file, and allow you to send by email.

Now let’s have a look at the full view of the transfer report editor when ‘For Client’ is selected:

Item 3 under the buttons ‘View Pdf’ and ‘View Summary’ allows you to enter the Bill of Lading details. It also lets you select which units will be printed in the transfer summary report, using the switches ‘Yes’/’No’ in front of each unit.

There are switches for mtons vac/air, ltons, M³ at 15°C and M³ at 60°F, Bbls and Gallons. In case the vessel is doing an STS transfer, there are two fields for applying VEF.

Item 4 under these switches lets you select whether the cargo operation is at a shore terminal or doing ship to ship. If you select ‘Terminal’, the fields for VEF are set to hidden.

Under the ‘Terminal/Ship to Ship’ switch you can enter details of the quantity loaded or discharged from / to terminal or other vessel:

As you can see we have entered here quantities both for Bill of Lading and for quantity received by the daughter vessel Alfa Centaur. Whether we use M³ at 15°C or M³ at 60°F depends on whether we have selected SI Metric or Imperial in general settings: in Europe you generally use SI Metric and consequently M³ at 15°C; in the US or other countries where Imperial units are adopted you use M³ at 60°F. The two switches for M³ at 15°C and 60°F cancel each other out: if you select ‘Yes’ for M³ at 15°C, the switch for M³ at 60°F is automatically set to ‘No’ and vice versa.

After filling in the required quantities and other details we can now press ‘View Pdf’ and the pdf report will be generated, as shown below. The report has been printed using SI Metric units in general settings.

If you wanted to print the report in Imperial units, then you should also select M³ at 60°F for the GSV Bbls under item 3 and item 4 and instead of M³ at 15°C, otherwise GSV quantities will not match.

Executive Summary report

Just like the other reports, once we generate the pdf (and jpg file, if we have set ‘Autosave pdf to photos’ on), we get the option to send the report by email.

In the mean time, for those who are interested in Cargo Surveyor for iOS: the app can be downloaded here:

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

Summer Zero Sale Cargo Surveyor for Android!

Download Cargo Surveyor for Android FOR FREE for 1 week!

Sale starts on 2nd August at 0000 hrs GMT (0800 hrs Philippines / Singapore etc).

 

Oilcalcs for iPhone iOS 10 and higher now available on App Store

Oilcalcs for iPhone iOS 10 version 1.2.0 has been approved by Apple and is now available for download here.

The new version of OilCalcs comes with several additions / improvements, and is the most comprehensive, flexible and versatile petroleum calculator in the market:

Newly added tools /features:

LNG density calculator:

LNG Density Calculator

 

A maximum of 9 constituents can be entered in the calculator. Values for constituent and mole fraction are stored inside the app in a database, for easy retrieval in future.

The app automatically checks if the total of mole fractions equals 1, and issues a warning for the following events:

– Missing constituent

– Missing mole fraction

– Total of fractions not equal to 1

– Temperature too low or too high

– Missing temperature

The density is calculated continuously when the user enters or changes values. The field to the right of the ‘Clear Entries’ button shows the total of mole fractions; if the total is not equal to 1, the text turns red, if it is exactly 1 the color turns green.

 

LNG density calculator error msg

In order to choose a constituent, simply press a constituent field, then the list of constituents shows up and you can select one from there. After entering your constituents and corresponding mole fractions and liquid temperature, the liquid density at temperature is shown. The density value is updated continuously, as long as all required entries are there.

To remove a constituent, scroll down to the bottom in the list of constituents and press ‘Delete’, this will delete both the constituent and the mole fraction if entered.

 

LNG constituents

The LPG density calculator has also been updated to work the same way as the new LNG density calculator.

 

Viscosity / pour point / flash point fuel blender:

Visco Blender

 

The visco blender can blend a maximum of 10 components of fuel, and calculates the resulting viscosity, density, pour point and flash point for the blend.

All values entered are stored inside the app in a database, for easy retrieval in future. Volumes can be entered either in M³ or Bbls, this depends on whether SI Metric or Imperial has been selected in settings. The resulting density or API is calculated accordingly.

There is a button “Clear Entries” that will delete all entries if pressed. This will reset the database completely.

Below this button you can find the entry picker: when you wish to make an entry for another component, swipe the picker to the next number you wish to use (between 1 and 10), and the data entered in the text fields for volume, metric tons, density, viscosity, flash point and pour point will be stored under that entry number.

Resulting density, viscosity, flash point and pour point are continuously re-calculated as long as the user keeps entering data.

Aside from the blender, there is a small utility (just above the picker) to calculate the required quantities (in metric tons) for two components to reach a target viscosity. All you have to do is enter the total quantity, enter the viscosities of the two components, and enter the target viscosity, and then the app will calculate the required quantity for each component.

 

 

 

 

 

 

 

 

Viscosity / temperature converter:

Visco Temperature Converter

 

The viscosity / temperature converter allows the user to find the viscosity at a given temperature, or the temperature at a given viscosity basis either one reference point (using the ‘V50’ formula), or basis two reference points (using the ‘Walther’ equation).

Temperatures can be entered either in °C or °F by swiping the temperature button. If temperature fields contain values, these are automatically converted.

The screen is divided into three parts:

– Upper part (using one reference only): after entering viscosity (e.g. 380 cSt) and corresponding temperature (e.g. 50 °C), if you then enter a temperature of e.g. 35 °C in the field for the alternative temperature, the resulting viscosity is shown as 1089.8 Likewise if you would enter a viscosity of 1089.8 cSt in the field for the alternative viscosity, the resulting temperature is shown as 35 °C.

– Middle part (Walter equation, using 2 reference points): after entering low temperature in T1, corresponding viscosity in V1, and entering high temperature in T2 and corresponding viscosity in V2, if you then enter an temperature of 50 °C in the alternative temperature field, a resulting viscosity of 324 cSt is shown. Likewise if you enter a viscosity of 380 cSt in the alternative viscosity field, a corresponding temperature of 47.6 °C is shown.

– The lower part contains two buttons and a graph. The button “Visco Limit” sets the height of the graph to the maximum viscosity that you wish to be displayed:

 

Changing viscosity limit

 

The “Show Walther” button changes view of the graph to the Walther equation, if data has been entered in the middle part. When you press the “Show Walther” button, the button text changes to “Show V50” and the Walther equation graph will be shown if data has been entered in the upper part. Likewise if you press the button (now with text ‘Show V50’) again, the V50 graph will be shown (if V50 data is available).

For those readers new to Oilcalcs for iOS, here follows a full description of the app:

Main calculator: Calculates for Crude, Products, Luboils, LPG/NGL and Special Applications:

Main calculator screen

– Convert inline (i.e. while using the calculator) from any density unit to another unit, in other words from observed density to density 15 / density 20 / relative density / API etc:

Select / convert density

– Set as calculation target any of GOV M³ / GOV Barrels / GSV M³ / GSV Barrels / Mtons in air / Mtons in vacuum etc, and have the other parameters calculated accordingly.

Select volume or weight

Select cargo type by pressing the ‘OilType’ button:

Select cargo type

– Switch between SI Metric and Imperial units and change between 1980 tables and 2004(2007) tables from within the calculator screen without having to go to the settings screen, using the ‘US’ / ‘2007’ buttons.

– Use the ‘Calculate’ button to copy all data from the main calculator screen to the Quantity Record editor, where the data can be saved. An unlimited number of entries can be saved; if you press the ‘Calculate’ button, the app will ask you if you wish to export results. If you press ‘OK’ then you will be presented with a window where you enter the title for the entry, and after pressing ‘OK’ there, you end up in the Quantity Record editor, where you can edit the data:

Quantity Record Editor

Other important features are:

1. The ‘More’ screen, that gives access to all utilities except main calculator, Convert and Settings:

More screen

2. Full access to all ASTM 2004/2007 Petroleum tables (including 2009 update): table 5 / 6 / 23 / 24 / 53 / 54 / 59 / 60 (All tables for Crude/Products/Luboils/Special Applications – A/B/D/C), in the ‘Convert’ screen:

Oil convert screen

The button ‘Table 5’ is used to select the desired table:

Convert screen tables

 

3. The option to carry out calculations either using ASTM 1980 tables or ASTM 2004/2007 tables and either using Metric tables or Imperial tables, by changing the selection in settings:

Settings metric 2007

Settings imperial 1980

 

4. Full access to the LPG/NGL tables (API MPMS 11.2.4 / 2007 Edition): table 23E / 24E / 53E / 54E / 59E / 60E. Note: table 24E / 54E and 60E can be accessed by going to the Calculate screen, setting the ‘OilType’ as ‘LPG/NGL’, and entering a relative density at 60 °F / density at 15 °C / density at 20 °C respectively and a temperature. The VCF (or CTL using contemporary naming conventions) will then show.

LPG / NGL converter

5. Density calculation module for LPG

LPG density calculator

6. Two different fuel blending tools.

Fuel blending – mix two volumes

Blender 1: mix two volumes

This blender also calculates the shrinkage as a result of the blending. It also shows which product should be loaded first, basis the difference in weight factor of the two components: as can be seen in the picture on the left, component no.1 has a higher density at 15°C, but since the temperature of no.1 is much higher than the temperature of no.2, ultimately the weight factor of no.2 component is higher than no.1, and no.2 should be loaded first.

 

 

 

 

 

 

 

 

Blender 2: Density after blending second component:

Fuel blending density after 2nd parcel

7. LPG/NGL liquid and vapor calculation sheets.

Gas calculation – liquid

Gas calculation – vapour

I should like to invite all users / readers to please leave comments / suggestions / criticism, both positive and negative all are welcome! After all, feedback is the only way for us at MMC to improve both our blog and the apps that we produce…:)

We post updates in the App Store frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Oilcalcs and we never will.

 Download in the App Store

 

Download dropbox for free

Cargo Surveyor for Android – Tutorials part 8: Transfer executive summary report

The tutorials part 8 for the Android version of Cargo Surveyor deals with the Transfer executive summary report.

In number 7 of the tutorials for Cargo Surveyor for Android we discussed in part the sixth document of the set of documents required to be produced in the load port, the ullage report.

Today we will discuss part 8 of the tutorials, which will deal with the transfer executive summary report:

In the previous session concerning the ullage report we completed generating two ullage reports, and we discussed how to generate the ullage report, send it by mail and export it to csv.

Once a cargo operation is completed, we can use the transfer executive summary utility to:

• Calculate cargo discharged or loaded (in the case of part discharge, and in case of loading multiple parcels such as with our Testship)
• Calculate comparisons between ship received / shore supplied, or in case of STS operations mother / daughter discharged / received
• Calculate comparisons between Bill of lading figures and ship discharged, or Bill of lading figures and ship received

To get to the Transfer report editor we first need to go to the list of reports (‘Pdf/jpg Reports’), which can be accessed by pressing the options menu button (on newer phones this in the top right hand corner of the screen); this options menu is available from within:

• the first screen when you open the app
• the tank configuration screen for standard layout
• the tank configuration screen for extended layout

After pressing the option ‘Pdf/jpg Reports’, the list of available types of reports appears. If you accessed this from the very first screen, a message comes up first, asking you to confirm whether to use standard or extended layout for ullage reports. The choice between extended and standard layout is very important for ullage reports and transfer summary reports, because depending on which layout you select you will only be able to select ullage reports that have the chosen layout:

After selecting ‘EXTENDED’ or ‘STANDARD’ (if asked to choose), from the list above you select ‘Transfer report’, and this will bring you to the  Transfer report editor:

When selecting ‘Transfer Report’ in the reports screen, you will be presented with the transfer report editor immediately. Inside this editor you can select the two ullage reports to use for producing the transfer report. When you press ‘Select’ next to the ‘Choose Before’ label, the list with available ullage reports will appear. You can select the one you want to use, choose whether you want to use the totals of all grades or one particular grade, and after that the name of that ullage report appears instead of the ‘Choose Before label’. The same goes for the ‘Choose After’ selection:

 

 

As you can see in the picture on the left side, our two earlier generated ullage reports have been selected: ‘Testship_after_s1’ and ‘Testship_after_s2’, and for each report the grade ‘ma’ has been selected. We could also have selected ‘TotalsAllGrades’ in this case since each report only contains one grade, but if the vessel were loading multiple grades then we would definitely have to select here the grade that we want to be calculated only.

You can also see that in step 2: Choose whether report for ship or client, the switch is set to ‘For Ship’. To produce the executive summary report we need to change it to ‘For Client’. After changing to ‘For Client’, a whole bunch of fields become visible where we can enter Bill of lading quantities and quantities loaded or discharged from / to terminal or other vessel.

If we leave the switch to the ‘For Ship’ setting, only the quantities before and after the operation are printed, and the total loaded or discharged quantity. No comparison is calculated between ship and shore or mother / daughter vessel, or ship / BL figures.

 

Below the ‘For Ship’ switch there are three buttons:

– View Summary: when pressed, this will show the total quantity loaded or discharged

 

 

 

– View Pdf: when pressed, this will generate the actual pdf (or jpg) file, and allow you to send by email, export to csv etc.

– Clear all entries: when pressed, this will clear all fields that show up when ‘For Client’ is selected. After selecting ‘For Client’ and entering data in the various quantity fields etc, all data entered there is stored in app settings, so that it is available the next time you opt to use the Transfer report. When you press the ‘Clear all entries’ button, all this data is cleared from the app settings.

Now let’s have a look at the full view of the transfer report editor when ‘For Client’ is selected:

Item 3 under the buttons ‘View Pdf’ and ‘View Summary’ allows you to enter any Bill of Lading details. It also lets you select which units will be printed in the transfer summary report, using the switches ‘Yes’/’No’ behind each unit.

There are switches for mtons vac/air, ltons, M³ at 15°C and M³ at 60°F, Bbls and Gallons. In case the vessel is doing an STS transfer, there are two switches for applying VEF.

Item 4 under these switches lets you select whether the cargo operation is at a shore terminal or doing ship to ship. If you select ‘Terminal’, the switches for VEF are set to ‘No’ and disabled, as shown in the picture.

Under the ‘Terminal’ switch you can enter details of the quantity loaded or discharged from / to terminal or other vessel.

As you can see we have entered here quantities both for Bill of Lading and for quantity supplied by the terminal. Whether we use M³ at 15°C or M³ at 60°F depends on whether we have selected SI Metric or Imperial in general settings: in Europe you generally use SI Metric and consequently M³ at 15°C; in the US or other countries where Imperial units are adopted you use M³ at 60°F. The two switches for M³ at 15°C and 60°F cancel each other out: if you select ‘Yes’ for M³ at 15°C, the switch for M³ at 60°F is automatically set to ‘No’ and vice versa.

After filling in the required quantities and other details we can now press ‘View Pdf’ and the pdf report will be generated, as shown below. The report has been printed using SI Metric units in general settings.

If you wanted to print the report in Imperial units, then you should also select M³ at 60°F for the GSV Bbls under item 3 and item 4 and instead of M³ at 15°C, otherwise GSV quantities will not match.

 

Just like the other reports, once we generate the pdf or jpg file, we get the option to send the report by email, export the report to csv, and email the csv, as discussed in the previous tutorials.

 

This ends the tutorial no.8. In the next tutorial we will discuss the sampling report.

In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

Cargo Surveyor for Android – Tutorials part 7: Ullage report – generating the pdf or jpg

The tutorials part 7 for the Android version of Cargo Surveyor is the second session of the Ullage report tutorial.

Recently we discussed in part the sixth document of the set of documents required to be produced in the load port, the ullage report.

Today we will discuss part 7 of the tutorials, which will deal with the remainder of the ullage report tutorial:

In the previous session concerning the ullage report we discussed how to enter data in the tank editor. We explained the function of the various buttons for changing units, and we discussed briefly the differences between the cargo types that are available. We will now discuss in more detail the use of the bottom line entries L1, L2 and L3 and we will enter all ullages for Testship upon completion of loading the 1st and 2nd parcel of mixed aromatics. After that we will show how to generate the ullage report, send it by mail and export it to csv.

First we will enter all data for the first ullage report. Let’s begin with saving a copy of the ullage report that we created in the last tutorial:

1: From the tank configuration screen, press ‘Open file’ and then press ‘Testship’ in the list of available ullage reports:

 

2: Press ‘Copy Data’ instead of ‘Load Data’; a copy of the original report is created, and let’s give the report the title ‘Testship after s1’. Any spaces entered in the file name will automatically be converted to underscores.

3: Now open ‘Testship_after_s1’ and fill in all the required data as shown below in the ullage report:

The density of the first parcel was 860.7 in vacuum, at 15 deg C, as supplied by the terminal. As discussed in one of the earlier tutorials, we are using ASTM tables 2004 version, with SI Metric settings.

If you do not get exactly the same figures as in the above report, the complete settings as used for our Testship are as follows:

You will have noticed that there are no entries for L1, L2 and L3; this vessel is fitted with deepwell pumps, and consequently has no bottom lines, so no quantities need to be added or deducted for bottom lines.

The use of bottom line entries is mostly applicable to VLCCs and SUEZ max vessels, where bottom line quantities tend to be big (around 300 M³ or more), and also to smaller size conventional tankers that are not fitted with deepwell pumps. Regardless of whether bottom lines are included in tank calibration tables or not, if the vessel carries more than one grade, and / or if not all tanks are used for loading or if one or more bottom lines remain empty after loading, the quantities to add or deduct to a grade due to bottom lines, need to be considered and entered accordingly in the ullage report.

In cases like our testship, where no bottom line quantities need to be entered, we could utilise L1, L2 and L3 for other tanks such as the Residual Oil Tank (if necessary).

Notice also that in pdf report settings we have changed the draft to 10.40 mtrs even keel upon completion of loading the first stage, and we have changed the setting of the ‘Before’ switch to ‘After’, to ensure that the ullage report shows ‘After loading’ instead of ‘Before Loading’.

Now let’s copy this ullage report into a new one, called ‘Testship after s2’, following the procedure as described above, and then we will open the newly copied ullage report in our tank editor and enter new ullages, volumes and density as shown in below ullage report.

Notice that in pdf report settings we have now changed the draft to 11.50 mtrs even keel upon completion of loading the second stage.

For the sake of convenience we will assume that all temperatures are still the same although in reality this is unlikely and we would normally do a full inspection including new temperatures. The new density is based on the mix by volume ratio of density of the first parcel (860.7) and the density of the second parcel (826.9):

Now that we have completed both ullage reports, we can have a look at how to generate the pdf / jpg, send it by email etc:

Upon completion of entering the data, after pressing the back button, we are back in the Tank Configuration screen. In the top right-hand corner of this screen there is an options menu, which if we press it, will shows links to ‘Current Totals’, ‘Settings’ etc and also ‘Pdf/jpg Reports’:

Pressing the link to ‘Pdf/jpg Reports’ will bring us to the Pdf reports section, where we can press on ‘Ullage Reports’ in order to generate our pdf or jpg image for the ullage report:

Now when we press ‘Ullage reports’, we will be presented with the list of available ullage reports:

As you can see, both ‘Testship_after_s1’ and ‘Testship_after_s2’ are in the list. If you press ‘Testship_after_s1’ you will be presented with the list of available grades within this report.

Normally there are always at least two entries in the list of grades: one entry called ‘TotalsAllGrades’, and one entry with a grade name that you have chosen when you created the ullage report. All existing grade names in the report will be listed here, and pressing a grade name will then produce an ullage report which will show only tanks containing that grade.

If you press ‘TotalsAllGrades’, the ullage report will show all tanks and a total cargo table, plus a breakdown of totals per grade. If you have entered only one grade, then there is no difference between selecting the grade name or selecting ‘TotalsAllGrades’, the report will be exactly the same.

So let us select the ‘ma’ grade. The first time you do this, the app will immediately show the pdf file (or the jpg image, more on that later) of the report as shown above. If later on you want to see the report again, the app will ask you ‘Entry exists, overwrite?’. If in the meantime you have made changes to the ullage report (changed ullages, or densities etc), then you need to select ‘OK’ and let the app overwrite the file.

After viewing the pdf or image file, if you press the back button, you will be asked if you want to send the ullage report by email; if you press ‘OK’ the app will then let you choose which email application to use (if you have more than one), and after selecting your preferred mail app, the mail composer shows up, with the pdf or jpg file already attached, and the subject of the mail entered as ‘Ullage Report (Pdf)’.

Also, if you have entered email addresses in the Pdf report settings, these addresses will already have been entered in the ‘To’ and ‘CC’ line. A maximum of 2 addresses will be entered in the ‘To’ line, and a maximum of 2 addresses will be entered in the ‘CC’ line. As you can see in the Pdf report settings screenshot below, a maximum of 4 email addresses can be entered automatically in the email. These addresses can either be entered manually, or be selected from your contacts. The first time you try to select addresses from your contacts the app will ask your permission to access your contacts.

After composing the email, it will either be sent to your outbox, or sent onto the web if you are connected and press the ‘send’ button in your email app. Once you close your email app, Cargo Surveyor will ask you if you wish to export the data to a csv file, and if you press ‘OK’ on that dialog, it will also ask you if you wish to send the csv file by email.

Both the pdf (or jpg) file and the csv file are stored on the internal storage of your phone. The pdf and the csv file can normally be found in the root of your internal storage. If you have opted to generate a jpg file (or if your phone runs an Android version lower than Kitkat – 4.4), a jpg file will be generated which will be saved in a directory called ‘saved_images’ in the root of your storage.

Cargo Surveyor will automatically detect if your phone is capable of generating pdf files, and will by default select the pdf format for reports if possible. If your phone is using an Android version below Kitkat 4.4, Cargo Surveyor will disable the choice between pdf and jpg, and will only produce jpg files.

What is the purpose of the csv (comma separated value) file? All the data inside the ullage report is put into a small text file, where each entry (this can be a number, or a combination of words) is separated from the next entry by a comma. This file can be opened by Microsoft Excel, and can be used to import the data from the ullage report into an excel spreadsheet. For advanced users it would also be possible to copy the exported csv file to another file (provided that you use the correct naming conventions etc) and generate a completely new ullage report from a desktop computer, which could then be imported to the phone by simply copying the csv file to the phone. More on that in a later tutorial.

In Cargo Surveyor this file is also used to backup and restore an ullage report (and most of the other reports can also make use of this). If you export an ullage report to csv, and wish to transfer the report to another phone where you also have Cargo Surveyor installed, all you have to do is copy the csv file to the other phone, and import the file into Cargo Surveyor on the other phone.

Another purpose is in case of corruption of the app, or if you completely uninstall the app and later want to re-install; if you have exported all your reports, it is very simple to import the csv files and have all your reports back with a minimum amount of effort.

We mentioned earlier in this tutorial the existence of an options menu in the top right-hand corner of the Tank Configuration screen; if you press the menu button and select ‘Current Totals’ while an ullage report has been loaded into memory, it will take you to a screen with the list of all grades within that ullage report and you can select a grade to view its totals.

Alternatively you can select the entry ‘Totals’ in the options menu, and select any existing ullage report, and then view for that selected ullage report its grand totals, or the totals for any grade:

Well, we have come to the end of tutorial no.7. In the next tutorial we will discuss the transfer executive summary.

In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

Cargo Surveyor for Android – Tutorials part 6: Ullage report – entering data in the editor

The tutorials part 6 for the Android version of Cargo Surveyor deals with the Ullage report.

Recently we discussed the fifth document of the set of documents required to be produced in the load port, the VEF report.

Today we will discuss part 6 of the tutorials, which will deal with the ullage report:

Cargo Surveyor is designed with user convenience and flexibility in mind. The app being used primarily on oil tankers and chemical tankers, we have chosen to give the user two different option sets regarding possible tank configurations:

• a standard layout, which accommodates a minimum of 12 tanks (5 pairs of wing tanks plus two slop tanks) and 3 bottom lines, and a maximum of 23 tanks (7 crosses plus two slop tanks) and 3 bottom lines.
• An extended layout, which accommodates a minimum of 34 tanks (16 pairs of wing tanks plus two slop tanks) and 3 bottom lines, and a maximum of 50 tanks (16 crosses plus two slop tanks) and 3 bottom lines.

The bottom lines and slop tanks can be used in any way the user wants to, they are simply considered as tanks just like the other tanks. (Not to be confused with actual bottom lines, which can either be included or excluded from tank tables). There are times however that the bottom lines L1, L2 and L3 are used to either add or deduct volume of cargo for a selected grade, and this depends indeed on whether bottom lines on the vessel are included in tank calibration tables or not, and what the grade of each bottom line is. More on this later.

When you open the app, the first screen that always appears is the layout selection screen, where you will be asked to choose between either the standard or the extended layout:

In the top right hand corner of this screen is also an options menu button, that will let you straight go to general settings etc.

For our testship, being a vessel with 6 pairs of wing tanks and 2 slop tanks (plus a residual oil tank), we will select the STANDARD layout. As soon as we press the button (‘USE STANDARD LAYOUT’) we are presented with the standard layout tank configuration editor:

At present only the ‘Open file’ button is enabled, all other buttons are disabled. If you previously created an ullage report than you can open that ullage report for editing by pressing the ‘Open file’ button and selecting the ullage report from the list of available reports. In our case we are going to create a new report from scratch so first we need to select the appropriate tank configuration; as soon as you press ‘Select tank configuration’, a pop up window appears where you can select a possible configuration. In these tank configurations slop tanks and bottom lines are not mentioned since they are always included:

For our testship we need to select ‘6W’: this will create an ullage report with 6 wing tanks + 2 slop tanks + 3 bottom lines. As soon as you press ‘6W’ on the drop down list in the above picture, you will notice that now all buttons 1-6P, 1-6S, Slop P, Slop S and L1, L2 and L3 buttons are enabled, as well as the ‘New File’ button.

We now press the ‘New File’ button; in the new window where we are asked to enter a file name, we can enter ‘Testship’ and press ‘OK’:

We are now taken directly to the tank editor (standard layout), with the new ullage report already created and opened and tank 1P selected:

Within the tank editor, the first thing we see in the top of the screen is 1P:SI Metric/2004. 1P is the name of the selected tank in the list of available tanks. SI Metric means that in general settings SI Metric units has been chosen, and 2004 indicates that ASTM 2004 tables have been selected.

There are five buttons on the screen for switching units (no.6 button ‘ULLAGE’ is only to indicate whether ullage or innage is being used, but presently this is not reflected in the actual report):

– ullage between meters and feet / inches: you can select this unit for each tank individually; this is handy in case the vessel has ullage tables using feet and inches while you want to make your report in metric units: first press the ‘MTRS’ button, so that the input changes to feet, inches. The title of the button now changes to ‘FT,IN’. Now enter the ullage (say for example ‘7, 8.5’). Now press the ‘FT,IN button again, and the ullage is automatically converted to 2.350 mtrs.

– temperature between deg C and deg F: same as with ullages, you can select the unit for each tank individually and convert between deg C and deg F with the press of a button, in this case the ‘DEG C’ button below the ‘MTRS’ button.

– density between density @ 15 deg C and API at 60 deg F: as with the other units, if you press the D15 button, the density (if you have entered one) will be automatically converted to API and the title of the button changes to ‘API’.

– volume between M³ and Bbls: likewise, if you press the M³ button, any volume you have entered will be converted to Bbls, and the title of the button will change to ‘BBLS’. Both volume in the volume field and the water dip field will be converted.

– thermal expansion coefficient (Alpha) between /deg C and /deg F: if you press the ‘DEG C’ button (below the M³ button), the expansion coefficient will be converted to /deg F.

All these units (except ullage) will be converted to the selected standard in the general settings when you generate the pdf report: if in general settings you have selected ‘SI Metric’, then all values will be printed in metric units, and if you have selected ‘Imperial’, then all values will be printed in imperial units.

Ullages however, will be printed depending on one particular setting in the pdf report settings: at the bottom of the pdf report settings there is an entry called ‘Keep ullages in original units’:

If this option is ticked, then ullages will be printed based on the ullage unit that has been used for the first tank: if the ullage of 1P is entered as ‘feet, in’ then all ullages will be printed in feet and decimal inches, regardless of whether you have selected metric or imperial units.

On the right hand side of the screen are fields to enter ullage, a maximum of three temperatures, the volume of any water in the tank, the density in vacuum at 15 deg C (or the API at 60 deg F), the tank volume, alpha (in case of special applications using table 54C or 6C and in case of chemicals), and the name of the grade.

If you have selected ‘Chemicals’ as cargo type, there is one additional field called ‘at temp’: here you can enter the temperature for the observed density (see below). Also the density button is disabled and will now have as title ‘DENSITY’ instead of ‘D15’. When chemicals is selected as cargo type, it is not possible to change the density unit to API.

At the bottom of the screen is the drop down to select the tank for which you want to enter data, currently pointing at 1P; to the left of the tank drop down is the cargo type selector, which you can set to either:

– Products

– Crude

– LubOil

– Special Applic(ations)

– Chemicals

If you select any cargo type except ‘Chemicals’, the ASTM tables are used for calculating the weights, VCF etc. In the case of Chemicals (not to confuse with ‘Special applications’) , the density is entered as observed density, together with a corresponding temperature for that density. In this case the ‘at temp’ and Alpha are used to calculate the actual weight in air. No GSV can be calculated since many chemicals such as FAME / vegetable oils are not even liquid at 15 deg C.

For all other cargo types the normal ASTM tables are used; which table is used for calculating the VCF depends on:

– The cargo type: if ‘Products’ is selected, either table 54B or 6B is used, if ‘Crude’ is selected, either table 54A or 6A is used etc.

– Whether in general settings ‘SI Metric’ or ‘Imperial’ has been selected; if Imperial is selected table 6B is used, if SI Metric is selected table 54B will be used. The same applies for Crude, LubOil and Special Applications.

Let us now enter an example referring to the screen shot below:

Testship will load the cargo of mixed aromatics in various stages, receiving parcels with different densities from different shore tanks.

Each parcel will be loaded evenly across all tanks so as to achieve a homogeneously commingled end product.

As can be seen in the picture on the left, we have entered an ullage of 15.62 mtrs, a temperature of 21 deg C, a density in vacuo at 15 deg C of 860.7, a volume of 2506 M³ and the grade name ‘ma’.

This grade name is arbitrary, you can enter any name you wish, as long as you ensure that this grade name is exactly the same for each tank carrying this grade, because the calculation of totals per grade is dependent on the grade name.

Now if you press the back button and return to the tank configuration screen, and then press the ‘1P’ button, you will see not only the info that we have just entered but also the VCF, GSV, MTons in air/vacuum, LTons, Bbls and Gallons are all displayed for this tank.

In the bottom of the screen the title of the report, as well as the grade name are displayed in an animated scrolling text field:

 

 

Phew! It has been a pretty long session already! We will take a break here, and discuss the remainder of the ullage report session in the next tutorial, part 7.

In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

Cargo Surveyor for Android – Tutorials part 5: VEF report

The tutorials part 5 for the Android version of Cargo Surveyor deals with the VEF report.

Recently we discussed the fourth document of the set of documents required to be produced in the load port, the Bunker report.

Today we will discuss part 5 of the tutorials, which will deal with the VEF report:

To get to the VEF editor we first need to go to the list of reports (‘Pdf/jpg Reports’), which can be accessed by pressing the options menu button (on newer phones this in the top right hand corner of the screen); this options menu is available from within:

• the first screen when you open the app
• the tank configuration screen for standard layout
• the tank configuration screen for extended layout

After pressing the option ‘Pdf/jpg Reports’, the list of available types of reports appears. If you accessed this from the very first screen, a message comes up first, asking you to confirm whether to use standard or extended layout for ullage reports. For VEF reports you can choose either, it makes no difference. The choice between extended and standard layout is only important for ullage reports and transfer summary reports:

After selecting ‘EXTENDED’ or ‘STANDARD’ (if applicable), from the list above you select ‘VEF reports’, and this will bring you to the list of available VEF reports. If this is the first time that you are going to create a VEF report, the list will show only one entry: ‘Create new entry’:

After pressing the ‘Create new entry’ line in the list, you will be asked to enter a title for the report, we can simply use our ‘Testship’ as title:

Once you press ‘OK’, the VEF reports list shows the new entry ‘Testship’. The here described process for accessing the pdf/jpg reports, and for creating a new pdf/jpg report is the same for all the reports except for the ullage report and transfer report; the ullage report is created from within the STANDARD and EXTENDED tank layout. The transfer report is created based on the selection of two existing ullage reports. More on this in future tutorials.

Now if you select the ‘Testship’ entry, the VEF reports editor appears if you select ‘Load/Edit data’ from the list of available actions:

The following controls are available:

 

1. Button to choose VEF for loading or discharging.
2. These 4 entries (vessel, cargo, port and date) will be supplied by report settings if they exist, and can be overwritten.
3. Buttons for choosing units, either Bbls, M³ GSV or Mtons. The units can only be changed when the first entry (‘Last’) is selected.
4. Voyage picker. There are altogether 20 voyage entries available.
5. For each voyage entry the data shown in the left hand picture should be entered.

 

 

The VEF report is created / edited and send by email / saved to phone from here. As with other reports, when you click the name of the report in the reports list, the app shows you a list of available reports or an entry titled ‘Create new entry’ if there are no available reports. If you select ‘Create new entry’ you can enter a ship name or other suitable title for the report.

As mentioned in the previous tutorials, within the list of available reports there is a shortcut to the settings page, to be able to quickly change settings such as whether to use SI Metric or Imperial. In the VEF report you can use the setting for selecting 1980 version or 2004 version table to change the number of decimals shown for the VEF.

Once your report is created and you select the report, you can delete, copy, edit or view the report, and also create a new report.

 

The first 4 entries are taken from report settings and can be overwritten manually.  The VEF editor has two settings: Units that are used for the quantities – Bbls, M³ or Mtons, and Operation – either loading or discharging. Normally the VEF is calculated for loading operations.

Once you are done with creating and editing and return to the list of reports, you can choose to view the report, and you will again be given the options to send by email and export to csv file as with other reports.

The report calculates the qualifying range, automatically excludes voyages with a gross ratio of more than 1.02 or less than 0.98 and voyages which deviate more than 0.3% from the average. If any other voyages need to be excluded you need to omit them from the list of entries (for reasons such as first voyage after dry dock etc).

Below you can see an example of the VEF report:

Note that the VEF is displayed in the above example with 5 decimals; if you wish to show the VEF using 4 decimals only, then you need to change the table version setting in general settings from ASTM 2004 to ASTM1980:

For more details on the reports in general (importing, exporting etc), please refer to the instruction manual, which can be downloaded from this website: in the top of the current page there is a tab named ‘User manuals for Oil Calculators’ where you can find the instruction manuals for most apps.

This is the end of part 5 of this tutorial; in part 6 we will discuss the ullage report. In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

Cargo Surveyor for Android – Tutorials part 3: Slop report

The tutorials part 3 for the Android version of Cargo Surveyor deals with the Slop report.

Recently we discussed the second document of the set of documents required to be produced in the load port, the OBQ report.

Today we will discuss part 3 of the tutorials, which will deal with the Slop report:

Upon completion of the tank inspection, we can also enter our findings in the Slop report editor, if applicable.

To get to the Slop report editor we first need to go to the list of reports (‘Pdf/jpg Reports’), which can be accessed by pressing the options menu button (on newer phones this in the top right hand corner of the screen); this options menu is available from within:

• the first screen when you open the app
• the tank configuration screen for standard layout
• the tank configuration screen for extended layout

After pressing the option ‘Pdf/jpg Reports’, the list of available types of reports appears. If you accessed this from the very first screen, a message comes up first, asking you to confirm whether to use standard or extended layout for ullage reports. For Slop reports you can choose either, it makes no difference. The choice between extended and standard layout is only important for ullage reports and transfer summary reports:

After selecting ‘EXTENDED’ or ‘STANDARD’ (if applicable), from the list above you select ‘Slop reports’, and this will bring you to the list of available Slop reports. If this is the first time that you are going to create a Slop report, the list will show only one entry: ‘Create new entry’:

After pressing the ‘Create new entry’ line in the list, you will be asked to enter a title for the report, we can simply use our ‘Testship’ as title:

Once you press ‘OK’, the Slop reports list shows the new entry ‘Testship’. The here described process for accessing the pdf/jpg reports, and for creating a new pdf/jpg report is the same for all the reports except for the ullage report and transfer report; the ullage report is created from within the STANDARD and EXTENDED tank layout. The transfer report is created based on the selection of two existing ullage reports. More on this in future tutorials.

Now if you select the ‘Testship’ entry, the Slop reports editor appears if you select ‘Load/Edit data’ from the list of available actions:

 

When we first open this editor, ship name, port, date and cargo name will already have been filled in if we entered this information in the report settings, as discussed earlier.

Below the field for the cargo name you can see the drop down for the tank number. This works the same as with the OBQ report. Although on our Testship the slop tanks are empty and designated to load our cargo of mixed aromatics, the ship does have one additional tank, the Residual Oil Tank, which we can name ‘ROT’ here.

Below the tank number drop down there are switches for the units of distance, volume and temperature, and we can choose between density and API. All these units can only be changed when the first tank is selected. Please note that if you select ‘Chemicals’ as cargo type, you do not have a choice between density and API.

Below these switches is the field for the tank name, initially showing ‘1’. As soon as you change the name of the tank, this change is reflected in the tank selector as well.

Once you have changed the tank name to what you want it to be (ROT in our example), we can set the cargo type: the available types are: Crude, Products, LubOils, Special (as in special applications) and Chemicals.

If you select ‘Special’ then an additional field will appear under the ‘d15’ field: ’Alpha/C’, for the thermal expansion coefficient.

Likewise if you select ‘Chemicals, instead of ‘d15’ the density unit will show ‘dens’, and two additional fields show up: the ‘Alpha/C’ field for the thermal expansion coefficient, and ‘Temp for density’, since the density entered is not the density at 15ºC when dealing with chemicals.

The user can enter as many tanks as required, and each tank can have a different cargo type, but cargo type before and after the operation must be the same. Therefore when the ‘Before’ switch is toggled to ‘After’, the cargo type drop down is disabled.

The switch next to ‘Before’ is used to toggle between loading and discharging. This setting can only be changed when the first tank and ‘Before’ are selected.

In our example we make sure that the switches are set to ‘Before’ and ‘Loading’ (this is the default setting when you create a new report).

The next switch is for selecting whether slops have been sampled or not. If you select ‘No’, a field will appear where you can state a reason, such as ‘not requested by client’ or ‘not applicable’.

Below this we will find all the data pertaining to this tank ‘Before loading’ and we can now fill this out. We know from the pre-loading report that the inspection was finished on 22/7/18 at 0936 hrs, so we can fill in the same data here, together with the data for the ROT tank: ullage, total volume, free water dip (or interface ullage), free water volume, if necessary temperature, density and Alpha, Temp for density.

Disclaimer text: if we leave this empty and we have entered a disclaimer text in Report settings, that disclaimer will be printed on the report. Otherwise the disclaimer entered here will be printed.

Below is an example of our slop report on arrival. As you can see the ‘After loading’ section is still completely empty, except for the density used.

Upon completion of loading the ROT tank will be inspected again, and then the remaining data can be entered and the full report can be issued:

A note on the cargo type: if we select ‘Chemicals’ instead of any of the other cargo types, the layout of the report will be slightly different: the GSV will be noted as ‘N/A’ because many of the chemicals (such as vegetable oils / FAME) have a density stated at 60ºC and the cargo would be solid at 15ºC. The below picture shows the difference.

 

This is the end of part 3 of this tutorial; in part 4 we will discuss the arrival bunker report. In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

 

Cargo Surveyor for Android – Tutorials part 2: OBQ report

The tutorials part 2 for the Android version of Cargo Surveyor deals with the OBQ report.

Recently we discussed the first document of the set of documents required to be produced in the load port, the pre-loading report.

Today we will discuss part 2 of the tutorials, which will deal with the OBQ report:

Upon completion of the tank inspection, we can enter our dips and wedge volumes in the OBQ report editor, and generate the report accordingly.

To get to the OBQ report editor we first need to go to the list of reports (‘Pdf/jpg Reports’), which can be accessed by pressing the options menu button (on newer phones this in the top right hand corner of the screen); this options menu is available from within:

• the first screen when you open the app
• the tank configuration screen for standard layout
• the tank configuration screen for extended layout

After pressing the option ‘Pdf/jpg Reports’, the list of available types of reports appears. If you accessed this from the very first screen, a message comes up first, asking you to confirm whether to use standard or extended layout for ullage reports. For OBQ reports you can choose either, it makes no difference. The choice between extended and standard layout is only important for ullage reports and transfer summary reports:

After selecting ‘EXTENDED’ or ‘STANDARD’ (if applicable), from the list above you select ‘ROB/OBQ reports’, and this will bring you to the list of available ROB/OBQ reports. If this is the first time that you are going to create a OBQ report, the list will show only one entry: ‘Create new entry’:

After pressing the ‘Create new entry’ line in the list, you will be asked to enter a title for the report, we can simply use our ‘Testship’ as title:

Once you press ‘OK’, the ROB/OBQ reports list shows the new entry ‘Testship’. The here described process for accessing the pdf/jpg reports, and for creating a new pdf/jpg report is the same for all the reports except for the ullage report and transfer report; the ullage report is created from within the STANDARD and EXTENDED tank layout. The transfer report is created based on the selection of two existing ullage reports. More on this in future tutorials.

Now if you select the ‘Testship’ entry, the OBQ reports editor appears if you select ‘Load/Edit data’ from the list of available actions:

When we first open this editor, ship name, port, date and cargo name will already have been filled in if we entered this information in the report settings, as discussed in part 1 of this tutorial.

We now first need to select whether this is an OBQ or an ROB report using the switch in the top of the editor (in the picture on the left the switch is already set to OBQ report). The difference between the two reports is that in OBQ report there is an entry for water dip / volume as well as for oil, whereas in the ROB report the entry for water dip/volume is missing.

Draft (in our example arrival drafts) and list if applicable can be entered, and we select either ‘Yes’ or ‘No’ for the question ‘Lines drained?’. Lines drained is actually not applicable for the OBQ report, it will be ignored in the actual report. It is only used for the ROB report.

Next down you can see the tank number drop down, which shows initially ‘1’. Below this tank drop down there is a drop down for choosing the innage units, either ‘Meters’ or ‘Ft, Inches’, and below that you can enter the tank name or number (such as ‘4C’, ‘1P’ etc). There is also a drop down for choosing between M3 and Bbls as volume unit. You can only switch between units when the first tank is selected.

You can either enter all tanks that were inspected, whether they were empty or not, or limit the report to tanks that actually contain OBQ. If you don’t fill in any information in the fields below the tank number drop down, and leave the tank name of the first tank as ‘1’, then the report will show just one line with tank data, and this line will simply be empty. The total amount of OBQ will also be shown as zero.

Alternatively you can make an entry for each individual tank and specify dips and wedge (or table) volumes as necessary. When you need to add a tank to the list, first make sure that you have given the desired name to the first tank, and then press the ‘+’ button.

A new entry will now be generated, which you can edit by selecting it in the drop down. In our current example, lets say that you named the first tank ‘1P’; as soon as you have changed the tank name on the first tank, this change will be reflected in the drop down, it will now show ‘1P’ instead of ‘1’. Now if you press the ‘+’ button, a message comes up saying ‘Tank (no. 2) added’. If you now press the drop down, you will see two entries in the list: ‘1P’, and ‘2’.

In order to edit the details for the 2nd tank, just press on ‘2’ in the list. If you had entered any details for the first tank, such as innage and wedge volume, these fields will now be empty and you can enter the correct data for this tank.

As you can see in the picture on the left, there are three fields for entering oil volume: Non liquid, Liquid(table) and Liquid(wedge). You only need to enter one liquid volume, either table or wedge. If you need the wedge volume you can press the ‘Wedge formula’ button to jump to the wedge formula tool to calculate the volume.

Below the entries for oil there are also two fields for water dip and volume.

You can mix table and wedge volumes for different tanks, the app will automatically calculate the totals of all three for all tanks. For each tank you also enter a remark if necessary.

Disclaimer text: if you have entered a disclaimer text in Report Settings, then that disclaimer will be used in the report instead of the disclaimer entered in the OBQ report editor.

An example of the completed OBQ report is shown here below:

 

This ends this tutorial. In part 3 we will discuss the Slop report.

In the mean time, for those who are interested in Cargo Surveyor for Android: the app can be downloaded here:

 

 

 

 

We post updates for the app in Google Play frequently to solve minor bugs, and advise all users to update as soon as a new update is available; we don’t use advertisements in Cargo Surveyor and we never will.

If you have any queries, suggestions, comments, criticism about the app or this blog post, please let us know! We always do our best to accommodate any requests for additions/modifications to our apps if they improve the value!

 

 

 

Cargo Surveyor for Android is out!

Cargo Surveyor for Android: a comprehensive set of tools for marine cargo surveyors, bunker surveyors, expeditors and chief officers on crude/product/chemical tankers.

After more than two years of development and intensive testing we have now published Cargo Surveyor Tools for Android!

Cargo Surveyor contains everything you need to carry out a complete cargo survey on oil and chemical tankers, and is designed with the aim to do all required tasks without laptop and hard copy tables.

Cargo Surveyor for Android is based on the same app for iOS, but has been given a whole set of extra functionality, such as importing and exporting to csv files, the capability to save / send as pdf file, the possibility to calculate chemicals such as vegetable oil, the addition of an extended tank layout for many more tanks, the inclusion of the bottom lines calculator and the addition of a Pre-Cargo Matrix, for checking the suitability of a cargo tank for loading the next cargo basis utilized tank cleaning methods and previous cargo history.

   Cargo Surveyor can be downloaded here.

 

Have all your forms and calculations in one app, on your phone!

 

Generate all your forms with the press of a button!

 

Sent interim reports by email to your client with one press!

 

Check total and transferred quantities in a snap!

 

Print ullage reports using Metric or Imperial units without hassle!

Print transfer reports using Metric or Imperial units without hassle!

 

Print bunker reports using Metric or Imperial units without hassle!

This post serves as a brief introduction to the app, a detailed tutorial will be published as soon as possible. A comprehensive manual has been published already and is available for free download on this blog, please see the page ‘User manuals for Oil Calculators’ (the link is in the top of the current page).

The toolbox contains (amongst others) the following items:

1: Fully configurable ullage form:

The user can choose the number of tanks, from a minimum set of 5 wing tanks plus two slop tanks, to a maximum set of 7 crosses plus two slop tanks, as well as three bottom lines in the standard layout:

The user can choose the number of tanks, from a minimum set of 8 wing tanks plus two slop tanks, to a maximum set of 48 crosses plus two slop tanks, as well as three bottom lines in the extended layout:

Regardless of the program’s main settings, ullages / temperatures / densities / volumes can be entered in either SI Metric or Imperial units. In the same report both Metric and Imperial units can be mixed, the app will automatically convert to the right units during processing.

Possible cargo types for the ullage reports are:

• Crude oil

• Products

• Special applications

• Lubrication oils

• Chemicals (such as vegetable oils)

When the time comes to save/print or email the report, the user can choose whether to use SI Metric or Imperial units, regardless of which units have been used during the creation of the report. An unlimited number of ullage reports can be saved, and existing reports can be cloned in order to create different reports for the same ship (i.e before and after discharging etc).

The report can be sent as an email attachment from within the app, and will automatically be saved as either a jpg file or a pdf file to the phone’s internal storage. If required, the file can then be transferred to a desktop computer for printing.

2: Fully configurable time sheet editor:

The time sheet editor comes with a whole bunch of standard entries but has ample room for new entries as required by the user. Events can be entered into the editor in any order, the app will automatically sort all entries by date and time. An unlimited number of time sheets can be saved, one for each ship and/or event as desired. Like the ullage report, the time sheet can be sent as an email attachment from within the app, and will be saved to the phone’s internal storage for transferring to a computer:

List of time sheet entries

Editing date, time and text of entry

3: Configurable wedge calculator:

The app contains a wedge calculator with the following features:

    – calculate wedge volume based on ship/tank dimensions

    – calculate wedge volume based on tank calibration table volume

    – calculate wedge volume using either Metric or Imperial units

Entries made are automatically saved and restored the next time the user opens the wedge calculator.

 

4: Instant tank totals view per grade, or for all grades together:

After creating an ullage sheet and filling in a grade name, temperature, volume and density (or API) for each tank, the user can view the tank totals, either per grade or the grand totals. The totals screen will give the totals of observed volume, gross standard volume, metric tons etc, as well as the physical average temperature of the cargo.

Available grades for an ullage report

Showing totals for one grade

Again regardless of what units have been used in the ullage report, the totals can be viewed in either Metric or Imperial units by choosing the desired unit in general settings.

 5: Detail view for each tank after entering data:

After entering data in the tank details editor, all data can be viewed for each tank in the first screen, using the buttons to select either a tank or a bottom line:

 

Details of tank 1P after entering data

Settings: from the context menu the user has access to a settings panel, where there are options to:

Default settings upon installation

 – chose ASTM tables 1980 or 2004

 – chose SI Metric or Imperial units and methods (i.e. whether to use table  6A or 54A for example)

 – chose whether to calculate metric tons in air using table 56 or using  density(vac) – 11 points

 – set the precision for vcf, gsv, metric tons etc

 – choose whether to use Table52 (1980) or (2004) when using ASTM tables 2004

Aside from all the above, the app contains a complete set of forms as  required by marine cargo surveyors:

 – Transfer summary (for vessel) and executive transfer summary (for the client)

– Pumping log

– OBQ / ROB report

– Slop report

– Reference heights and raw measurements report

– Bunker report

– VEF report

– Preloading report

– Sampling report

– Master’s receipt of samples report

– Standard protest letters (such as ship/shore diff, ship fig/BL diff, in transit diff)

– Standard Statement of Facts letters (such as H2S / HC in cargo tanks, Inert Gas in tanks)

– Fully customisable Notice of Discrepancy and Statement of Facts forms

A much more detailed post will appear shortly, with a comprehensive tutorial on how to effectively use the app.

   In the mean time, Cargo Surveyor can be downloaded here.

For more information about the app, with lots of screenshots and a concise outline of how to use most features, please download the instruction manual from this blog.