Version 1.0.4 of Tank Totals Calculator for Android has been published today, and is available on Google Play:
The new version of Tank Totals Calculator contains several improvements and enhancements based on requests by users:
- The old version was limited to a maximum of 26 tanks (7 pairs of wing tanks, 7 center tanks, 2 slop tanks and 3 bottom lines). The new version lets the user choose between standard layout (26 tanks maximum, as in the old version) and an extended layout, which offers a maximum of 53 tanks (16 pairs of wing tanks, 16 center tanks, 2 slop tanks and 3 bottom lines).
- In the new version, an option has been created that lets the user indicate in the tank details editor whether ullage or innage is used for the recorded level, for each tank individually. Whether a level is an ullage or innage is also reflected in the tank details view:
Other features have not changed. For the near future we still have the following additions in the planning:
- Create pdf ullage report that can be sent by email and stored on the phone.
- Exporting ullage report data to an excel (cvs) file, for import into a customized excel spreadsheet.
Tank Totals Calculator is available for download on Google Play:
Today (3rd January 2015) version 1.2.2 of CargoSurveyor Tools for iOS was published.
The update contains numerous performance improvements as well as several bug fixes, the most important one being the app crashing on some phones when viewing transfer summary (not the pdf version).
CargoSurveyor can be downloaded here.
We should like to advise everyone that has downloaded the app in the past to update as soon as possible to ensure a flawless CargoSurveyor experience.
For any problems, questions etc please post on our blog, or email us at email@example.com.
A detailed instruction manual is currently under production, and will be available on our blog as soon as possible.
In the meantime, useful tips can be found in the presentation on Slideshare.net.
Some of you may wonder why the jump in version from 1.1.0 to 1.2.2: this has to do with the way Apple manages versioning info and the limitation they have applied to the maximum number of binaries that can be submitted for a specific version, and is not really within the developer’s control.
As you may have seen, a few days ago Tank Totals Calculator for Android was published and is now available on Google Play for download:
To provide users with a good idea how to use this app effectively, we have compiled the following tutorial, which discusses all available features, and gives tips on how to use the app to the fullest.
1. Getting started: check your settings
Upon opening the app for the first time, it is a good idea to check out the default settings and see if anything needs to be changed to suit your needs:
To go to settings, hit the menu button, or touch the menu icon in the top right corner (if you are using a tablet without menu button), and select ‘Settings':
Default settings when you first download the app are:
- Using SI Metric standards
- Using ASTM 1980 tables
- Using density – 11 points for conversion of Metric tons in vacuo to air
- Not all notifications are shown
- Precision for VCF: 4 decimals
- Precision for GSV: 3 decimals
- Precision for Mtons: 3 decimals
- Precision for Ltons: 2 decimals
- Precision for Barrels: 0 decimals
If you are based in the US or other countries where the Imperial standards are utilised, then you need to select ‘Imperial’ instead of ‘SI Metric’. The same goes for the choice between ASTM 1980 and 2004 tables: in the US and Europe, as well as various countries in Asia (for instance Korea) the 2004 tables are used, whereas in for instance Singapore mostly 1980 tables are being used.
When you select ASTM 1980, automatically the VCF precision is set to 4 digits, whereas if you choose the ASTM 2004 tables, VCF precision is set to 5 digits. This can however be overridden by simply selecting a different value in the drop down next to ‘VCF'; in the same manner the precision settings for GSV etc can be changed:
Notifications: this is primarily for debugging purposes. If you enable ‘Show All’ then the app notifies you of all updates being made to the database, so unless you really need to see those notifications, it is better to keep this unselected (which is the default).
Okay, lets start with our example report. Say you are in Boston in the winter, attending the discharging operation of a product tanker named ‘ocean pride’ which has 6 pairs of wing tanks, 2 slop tanks, and 3 bottom lines. The client for whom you are doing the cargo survey has requested you to deliver reports using Imperial Standards conform the ASTM 2004 tables.
So in this case we would select ‘Imperial’ and ‘ASTM 2007′ (the 2007 refers to the fact that this is the 2007 amendment of the 2004 standard). It does not matter in this case whether you select ‘Use table 56′ or ‘Use Dens – 11′ because that setting only applies to SI Metric standards.
2. Getting started: configure your tanks, and create a report.
Lets head back to the main screen now to configure tanks, and create our first ullage report; you will see that presently the drop down shows ‘Select tank configuration’, and the tank buttons as well as the ‘New File’ button are all disabled:
Now select the tank configuration drop down, and select ‘6W': this will create a report with 6 pairs of wing tanks, 2 slop tanks and 3 bottom lines. The 2 slop tanks and 3 bottom lines are always included:
After selecting ‘6W’ we now have 6 pairs of wing tanks, the slop tanks and the bottom lines enabled, as well as the ‘New File’ button:
Now press the ‘New File’ button, and enter the filename ‘ocean pride':
After pressing ‘OK’ in the filename dialog, the app automatically takes you to the tank details editor and you can start filling in the data for each tank:
Let us assume that the ship is carrying the following cargoes:
- 1 parcel of ethanol, in 2W, 5W and slop tanks:
dens at 15°C in vacuo = 794.1
thermal expansion coefficient = 0.00086 /°C
We will use ‘eth’ as grade name
– 1 parcel of gasoil, in 1W, 3W, 4W and 6W:
dens at 15°C in vacuo = 835.2
We will use ‘go’ as grade name
We do our tank inspection together with the chief officer, obtain drafts and ullages, temperatures and water dips from all cargo tanks. After that we can use the ship’s cargo tank calibration tables to establish the observed volume of cargo in each tank.
3. Getting started: enter your data
Now that we have all this information, we can enter volumes, temperatures, densities and water dips in our tank details editor. A maximum of three temperatures can be entered for each tank, but the app only needs one temperature to calculate, and it will automatically calculate the average temperature regardless of how many temperatures you enter. For calculation purposes we do not need the ullages, but if you want to keep a full record, then by all means enter the ullages as well.
Depending on whether the ship’s tables use metres or feet/inches, and M³ or Barrels, we can change the unit settings in the tank details editor, for each individual tank. In the editor it is not necessary to stick to either Metric or Imperial units only, we could use Barrels for volume whilst using deg Celsius for temperature, and density instead of API. The totals report will reflect all values in the unit as selected in the settings screen, regardless of which units have been used in the tank editor.
To illustrate this, let us enter the data for tank 1P in metric units:
And now lets look at the totals screen for gasoil, we have only entered data for 1P, so the totals equals only the quantity inside 1P:
As you can see in the above totals screen, although we entered all data in metric units, the totals are displayed in Imperial units since that is what we selected in settings. If we want to see the totals in Metric units instead, all we need to do is change to ‘SI Metric’ in settings, and the totals will then be shown accordingly, as can be seen in the following picture. Please note that M³ observed is shown corrected for water dip:
We should also have a look at one of the ethanol tanks to see how data is entered there: first of all we need to enter the thermal expansion factor (or ‘alpha’, or ‘linear correction factor’), which was specified above as 0.00086 /° C. If the factor is given as /°F, we can change the unit by pressing the ‘deg C’ button next to the ‘Alpha’ label to change it, for the calculation it makes no difference, the app automatically calculates correctly, provided that you have selected the unit that corresponds to the value you have entered. So if you wanted to enter the correction factor in /°F, the value would have been 0.000477778 instead.
Please note that inline conversion is available for all entries; for example if you enter an ullage as 2.13 meters, and you then press the ‘Mtrs’ button, the value will be converted to ‘6, 6.7′ meaning 6 ft and 6.7 inch, and the title on the button changes to ‘Ft,in’. If you enter a temperature of 41°C, and you then press the ‘deg C’ button, the temperature value is automatically converted and becomes 105.80, and the title of the button changes to ‘deg F’. If the other temperature fields also contain values, these are of course also converted. This is how it works for all units.
In order to calculate for special applications, use the drop down in the bottom left corner of the tank details editor to select ‘Special applic’, and enter the correction factor of 0.00086, using ‘/deg C’ as shown in below picture. Likewise, if you are dealing with crude oil you should select ‘Crude’ etc. Products is used for all black and white products, such as gas oil, heavy fuel oil:
Now we can enter for all tanks the values for temperatures, volumes, densities etc. Lets assume that during the tank inspection the following values were established, in the order of ullage/average temp/water dip / total tank volume / grade name:
1P: 2.13 / 10.5 / 0.5 / 6500.32 / go
2P: 6.22 / 10.6 / 0 / 4300.54 / eth
3P: 2.50 / 12.3 / 0 / 6457.23 / go
4P: 2.52 / 11.6 / 0 / 6448.14 / go
5P: 6.50 / 10.4 / 0 / 4152.72 / eth
6P: 2.49 / 11.8 / 0 / 6452.45 / go
PSlop: 6.38 / 18.2 / 0 / 1257.41 / eth
1S: 2.14 / 10.4 / 0.5 / 6496.61 / go
2S: 6.21 / 10.3 / 0 / 4304.12 / eth
3S: 2.51 / 12.4 / 0 / 6453.55 / go
4S: 2.53 / 11.5 / 0 / 6444.76 / go
5S: 6.51 / 10.5 / 0 / 4148.26 / eth
6S: 2.50 / 11.7 / 0 / 6448.89 / go
SSlop: 6.39 / 18.6 / 0 / 1256.56 / eth
Please note that it is important to enter a grade name in each tank that you are using, otherwise the tank will not be considered in the calculation of totals for a specific grade!
On our example ship the bottom line volumes are included in the tables so we cannot declare them separately, and therefore we leave the entries for the bottom lines empty.
4. Getting started: Looking at total volumes and weights
Adding up all observed volumes gives us a total of 71,121.56 M³. The total amount of water is 1 M³ so the total observed volume that will be displayed is 71,120.56. To check this, temporarily select ‘SI Metric’ in settings, and then select ‘Current Totals’ from the tank configuration screen:
After selecting ‘Current Totals’ , a screen with the available grades pops up, where you can choose the totals for either gasoil, ethanol, or the grand total:
Selecting ‘TotalsAllGrades’ then shows us the totals of all tanks, in Metric units:
The total observed volume matches (tank totals – total of water dips), great! Now head back to settings one more time, select ‘Imperial’, and we can then look at the totals for each grade, in Imperial units as was requested by our client:
The two totals screens now show the observed volume in Barrels, GSV is shown in M³ at 60°F, and the average temperature (for the grade) also in °F. When you select ‘SI Metric’, observed volume is shown in M³, GSV is shown in M³ at 15°C and average temperature is also shown in °C.
Having seen the totals, we can also see all details including the calculated weights and volumes for each individual tank, on the tank configuration screen. As long as we have loaded an ullage report, the tank buttons for the chosen tank configuration remain enabled and we can look at the details for the configured tanks at any time again:
5. Getting started: a little more on the main menu:
As you have seen earlier, by pressing either the menu button on the phone, or pressing the menu icon in the top right corner of the screen (in case of a tablet without menu button), you gain access to the following items:
- Current Totals: shows the totals for the currently loaded ullage report
- Settings: see above
- Wedge Calculator: see below
- Totals: lets the user browse all available ullage reports for totals
- About Tank Totals: general info and links to publisher websites
5. Getting started: using the wedge calculator
The wedge calculator can be accessed by selecting ‘Wedge Calculator’ in the menu on the tank configuration screen, just like the settings screen etc. When nothing is filled in yet, the various text fields show hints as to what is required to be entered (for instance tank sounding is in centimetres, but ship’s length is in metres):
The default setting uses Metric units, but by pressing the On/Off switch on the bottom, you can choose between Imperial and Metric units. Any existing values in the text fields are automatically converted to their counterparts:
Once you enter values in the wedge calculator, they are stored in the app for retrieval the next time. The calculator also has a switch that lets you choose whether you want to use only ship’s tank dimensions for wedge calculation, or use the tank calibration table volume to calculate the wedge. The entry for the table volume is automatically hidden if not in use:
6. Getting started: file management:
As discussed earlier in this tutorial, a new ullage report is created by selecting a tank configuration, pressing the ‘New File’ button, entering a name and pressing ‘OK’. Once you have created your first ullage report, you can browse existing ullage reports by pressing the ‘Open File’ button, and a list of available ullage reports will then appear:
You select any ullage report by simply pressing it, and it will then load in the tank details editor. If instead you long-press on an item, you will be presented with three options as shown here:
- Load Data: load the selected report
- Delete Data: delete the selected report; this cannot be undone
- Copy Data: create a new ullage report using the data of this report. This is very handy if you want to create both before discharging and after discharging reports etc for the same ship.
Well, that brings us to the end of this tutorial! I hope you had as much fun reading this whilst trying out the app, as we had writing up the script…:)
If you are interested in Tank Totals Calculator for Android, the app can be downloaded from Google Play here:
We value your feedback! (honestly, we really do!). Any comments / criticism / suggestions will be very welcome, and can be posted either here, or in our facebook page. Alternatively you can send an email directly to firstname.lastname@example.org.
Watch this space for more news on our apps for Android and iPhone!
Oilcalcs for Android (the free version) was updated today upon request by several users, with the following additional features:
- Conversion of observed density to density at 15 deg Celsius
- Customizing of background colors and text colors for the various screens
The latest version has a revamped interface, and an option has been added to the settings screen, where users can choose the colors for background and text:
Also the conversion screen has been completely overhauled, a text field has been added to enter observed density, and the app now automatically converts all values as the user types them, without the need for pushing any buttons.
There is however a ‘cargotype’ button, since API / density conversion is oil type dependent.
Any of the text fields can be used as a starting point for entry; if the user enters an API value, then automatically density at 15 deg C and relative density are calculated. Likewise if observed density and temperature are entered (either in deg C or deg F), the corresponding values for API, density at 15 deg C and relative density are calculated.
In the settings screen there are now two sliders, one for adjusting the background color, and one for adjusting the text color. Changes are immediately reflected in the screen and are being saved when the user presses the ‘save’ button, or presses the ‘back’ key.
If the resulting theme is not what the user wanted, simply pressing the ‘defaults’ button will result in all default settings being restored, including background and text colors.
In the main calculator screen the button has been removed as it is not necessary; calculations are done automatically as the user enters data.
How the screens look depends on the Android version of the tablet / phone on which the app is installed. For instance the above picture shows the calculator screen on Android 4.04 tablet.
In the picture below the same screen can be seen on an Android 2.3 phone:
Oil Calcs for Android (free version) can be downloaded in the Google Play store here:
Alternatively, if you are looking for a calculator with more options (such as calculating using both ASTM 1980 and 2004 tables, calculations for Special Applications, LPG/NGL calculations), then Oil Calculator Pro is a better option, which can be found here:
And if you are looking for a complete solution, in order for example to calculate weights and volume for a whole bunch of tanks together (in a ship or tank farm) then Tank Totals Calculator is the perfect app for you, and can be downloaded here:
Today, just in time for Xmas, we have published a new Android app: ‘Tank Totals Calculator’. In the spirit of Xmas we have kept the price at a mere 2 USD until the end of this year;
after New Year the app will be available for its regular price (10 USD).Update: for a limited time Tank Totals Calculator will remain available for only 2 USD!
Tank Totals Calculator is kind of a lite but equally powerful version of the iPhone ‘CargoSurveyor Tools’.
The main reason for this release instead of CargoSurveyor Tools for Android is that we’re not yet quite ready to publish the Android version of CargoSurveyor Tools. There is still a lot of work to do porting the iOS app to Android.
Tank Totals Calculator therefore is an abridged version of CargoSurveyor Tools, that lets the user do mainly the following things:
1. Configure the number of tanks required for the ullage report: a maximum of 26 tanks can be configured, meaning a total of 7 pairs of wing tanks plus 7 center tanks plus 2 slop tanks and 3 bottom lines. These could of course also be used as for example residue tanks. The minimum is five sets of wing tanks plus 2 slop tanks and 3 bottom lines, in other words 15 tanks.
2. Enter necessary data (temperature, volume, density, etc) for each tank: regardless of whether the user has chosen SI Metric or Imperial units, the units used for ullage, temperature, density, volume and thermal expansion factor (Alpha) can be changed for each tank independently. Any existing value in the corresponding text field is inline converted to the newly selected unit. Density can be entered in any format, i.e 986.4 or 9864 or 0.9864; the app will automatically convert the value to the required format.
The app can calculate for Crude, all black and white products, Lubrication oils and Special applications (such as denatured Ethanol).
3. Calculate wedge volumes for ROB or OBQ calculation purposes: here also, regardless of chosen standard, units can be changed between Metric and Imperial and any existing values are automatically converted. Any values entered are stored in the app and available the next time the app is opened.
4. Calculate total weights and volumes, for each grade and for all grades together, in a totals report: the units used in the totals report depend on the chosen standard in the settings, not on the units used when entering tank data. All calculations are done conform the latest API MPMS standards.
5. View all calculated data for each tank, in a tank details view: The data will be displayed according to the standard chosen in settings.
The app contains a settings panel where the user can choose the following:
1. Whether to use SI Metric (i.e. table 54) or Imperial (i.e. table 6) standards
2. Whether to use ASTM 1980 or ASTM 2004 (with 2007 amendments) tables
3. Whether to receive notifications for all data handling. This is recommended to be set as not selected to make it easy on the eyes and is primarily for debugging purposes.
4. Precision settings for volumes and weights. If not selected, these will be set automatically depending on whether ASTM 1980 or 2004 has been chosen.
All reports are stored on the smartphone and can be retrieved at any time. There is no limit to the number of reports that can be made. Existing reports can be copied with a new name, to easily produce reports before and after loading for example. Using the built in file browser, reports can be deleted or copied by long-pressing on an entry and choosing to either load, copy or delete the entry:
Additional features that are planned for adding are:
- Producing ullage reports and totals reports as a pdf file that can be sent directly from the smartphone as an email, or saved on the sd card.
- Exporting the data as a CSV file which can be imported into an excel spreadsheet.
In the meantime, Tank Totals Calculator can be downloaded in the Google Play store here.
Tank Totals Calculator runs on any Android device from the early Gingerbread to the latest version (Lollipop).
We are proud to finally introduce our latest iPhone app – CargoSurveyor: a comprehensive set of tools for marine cargo surveyors, bunker surveyors, expeditors and chief officers on crude/product/chemical tankers.
After two years of development and intensive testing we have now released CargoSurveyor Tools!
CargoSurveyor 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.
CargoSurveyor can be downloaded here.
This post serves as a brief introduction to the app, a detailed tutorial and a comprehensive manual will be published as soon as possible. A reasonably detailed presentation with lots of screenshots can be downloaded on slideshare.
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:
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.
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 send as an email attachment from within the app, and can also be saved as a png file to the camera roll. If required, the png 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 send as an email attachment from within the app, and can be saved to the camera roll for transferring to a computer:
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.
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: