Draw Polygon Tool

1) Introduction

2) Drawing a Polygon on the Map

3) Using the Edit Tool

4) Analysing the data within your Polygon

5) Other Legend Tools

6) Troubleshooting

1) Introduction

This tool allows you to draw a polygon on a NABIS map page and request a report summarising the commercial catch data taken within the polygon area.  The report returns data for any fishing event where the fisher has reported catch taken within the boundaries of the polygon.  The data returned only relates to those forms which currently have latitude/longitude reporting AND the start point falls within the polygon.

Return to top of page.

2) Drawing a Polygon on the Map

1.    Open the NABIS map page. 

2.    Select the 'Draw Polygon' tool from the map tools toolbar (at the top of the map) - your cursor will turn into a cross.

3.    Click a starting point for the polygon on the map page.

4.    Continue to click to add segments to your polygon.

5.    When you are ready to complete the polygon, double-click the last point.  A star will appear at each point you have clicked and the map will show your polygon with a black outline.

You can draw more than one polygon on your map at any time, just re-select the 'Draw Polygon' tool and draw another polygon.  Each polygon will appear separately in the map legend.

Return to top of page.

3) Using the Edit Tool

Once the polygon has been drawn you can edit it using the 'Edit' tool in the map legend.  This allows you to edit coordinates, add labels and re-name the polygon.  You can edit each polygon on your map separately through the legend of the polygon.

 a) Editing the points of a polygon

1.    Click on the Map Legend tab

2.    Click on the 'User Polygon' legend item.  This will expand the legend item and give you a number of legend tools.

3.    Click on the 'Edit' legend tool.  This will take you to the Edit User PolygonX (Polygon) page, which shows the latitude and longitude of each point of your polygon.

4.    Click in any of the latitude or longitude fields to edit an individual polygon point.  You can only make changes to the latitude and longitude fields in decimal degree format.  If you have coordinates in degrees decimal minutes or degrees minutes seconds, use the table below to convert your coordinates into decimal format.

5.    You can insert or delete coordinates by using the insert and delete button to the right of the coordinate (note: 'delete' can sometimes be undone by using the browser back button and insert will add a new blank coordinate line above the line you have clicked).

7.     Enter the new coordinates in Decimal degree format (see conversion instructions below).

8.     Click Save to save any changes that you have made and return to the map window.  The map will display any changes that you have made to the coordinates (click cancel and you will return to the map without making any changes).

 

 Converting from Degrees Decimal Minutes to Decimal Degrees

 Latitude

 Longitude

Divide the minutes by 60:

15.06/60 = .251

Add this to the original degree figure (42).  If the latitude hemisphere is south (as all NZ points will be) ensure that the number is negative, if the hemisphere is north the number should be positive.

Divide the minutes by 60:

42.37/60 = .70616667

Add this to the original degree figure (172).  If the longitude hemisphere is east (most NZ points) ensure that the number is positive, if the hemisphere is west the number should be negative.

42°15.06'S converts to -42.251°S

172°42.37'E converts to 172.70616667°E

Converting from Degrees Minutes Seconds to Decimal Degrees

 Latitude

 Longitude

Divide the minutes by 60:

12/60 = .2

Divide the seconds by 3600:

32.4/3600 = .009

Add these together:

.2+.009 = .209

Add this to the original degree figure (42).  If the latitude hemisphere is south (as all NZ points will be) ensure that the number is negative, if the hemisphere is north the number should be positive.

Divide the minutes by 60:

28/60 = .466667

Divide the seconds by 3600:

49.5/3600 = .01375

Add these together:

.466667+.01375 = .480417 (rounded)

Add this to the original degree figure (174).  If the longitude hemisphere is east (most NZ points) ensure that the number is positive, if the hemisphere is west the number should be negative.

42°12'32.4"S converts to -42.209°S

174°28'49.5"E converts to 174.480417°E

 Note: Although the NABIS polygon editor will ONLY accept points in decimal degrees, it will allow you to enter this in two different formats:

42.23513°S and 175.24365°E OR  -42.23513 and 175.24365

 b) Adding labels to your polygon

1.        Click on the Map Legend tab

2.        Click on the 'User Polygon' legend item.  This will expand the legend item and give you a number of legend tools.

3.        Click on the 'Edit' legend tool.  This will take you to the Edit Polygon page, which shows the latitude and longitude of each point of your polygon.

4.        Click the 'Add Labels' button.

5.        Type labels in the new column that appears alongside your coordinate positions.

6.        Click Save to save your changes and return to the map page - your labels will now be shown on the map.  If you cannot see all of your labels, zoom in slightly (labels will appear only if another label is not overlapping with it, the more you zoom in, the more the labels will spread out).

7.        Click cancel and you will return to the map without making any changes.

 c) Renaming your polygon

1.        You can rename you polygon by typing in the "Layer Title:" text entry box.

2.        Click Save to save your changes and return to the map page - your labels will now be shown on the map.

3.        Click cancel and you will return to the map without making any changes.

 d) Inside NZ Region: 

 This feature helps validate your data, if your coordinates are not formatted for the correct hamispehere then an validation error will occur.

4) Using the Analyse Fishing Tool (MINISTRY OF FISHERIES STAFF ONLY)

Once the polygon has been drawn you can export and map fishing effort data using the 'Analyse Fishing' tool on the map legend.  This allows you to create a buffer, then choose a species and/or method and/or a date range for the data.  You can analyse fishing data for each polygon on your map separately through the legend of the polygon.

NOTE: The data is limited to catch effort data that has been reported using latitude and longitude positions and can also be limited by the accuracy of the positions provided by fishers.

a)Adding a buffer to your polygon

1.        Enter a number in the buffer box and select the unit (kilometres or nautical miles).

2.        Choose the data to analyse, as indicated in the table below.

THEN EITHER:

3.        Click 'Show on Map' to return to the map page and display the data (if a buffer was specified it will now appear on the map around your drawn polygon - every point of the buffer line is drawn 'x' number of nautical miles or kilometres from the edge of your polygon).

OR

3.        Click 'Run Report' - the report will open in the same window.  You can browse through the list that has been generated, or use the 'export' function to export your report into a range of different formats (click the 'select a format' dropdown).

4.     Click 'show on map' from the report page to show the data contained in the report on the map window or click 'proceed to map' to return to the map without adding the points in the report.

OR

3.        Click 'Proceed to Map' and you will return to the map without making any changes.

Data selections for analysis:

Field Name

Function

Species

Data can only be analysed for one or all species at a time. These are ordered by species code. You can type the code once the drop down list has been activated to go straight to the code.

Method

Data can be restricted further by fishing method. You can select one or more fishing methods from the list provided. Multiple selections can be made by holding down the 'Ctrl' key while you select each method you require to be included.

Year Type

Data can be restricted by year. You can choose to analyse data by either fishing year or calendar year by selecting from the drop down list.  

Year Range

When Fishing Year is selected the data is presented by fishing year either: 1 October - 30 September or 1 April - 31 March depending on the species you choose.  (Most species are reported against an October fishing year but there are a few that report against an April fishing year).

When Calendar Year is selected the year range changes to display full calendar years i.e. 2008.

Multiple selections can be made by holding down the 'Ctrl' key while you select each year you require to be included.

Month

Data can be restricted by month in combination with year(s). Multiple selections can be made by holding down the 'Ctrl' key while you select each month you require to be included.

An explanation of the fields in the NabisAnalysis.csv file: 

 Field Name

Description

Event Key

The ID for the fishing event as recorded on the form

Form Number

Individual form number as in the catch effort system.  Each form number is a hyperlink which takes you to the form image

Form Type

The form type short code

GreenweightKGQuantity

The greenweight figure recorded on the form (kilograms)

MeatweightKGQuantity

The meatweight figure recorded on the form (kilograms)

Unit Quantity

The unit quantity recorded on the form

Species Code

The species caught

Fishstock Code

Derived from the latitude/longitude location recorded on the form

Fishing Method Code

The method recorded on the form

Target Species Code

The species targeted as outlined on the form

Vessel ID with Vessel Name

The fishing vessel used

Fishing Year Full Name

The fishing year in which the fishing event took place

Calendar Month Short Name

The month in which the fishing event took place

StartLongitude

This is as recorded by the fisher usually to the nearest degree minute.

StartLatitude

This is as recorded by the fisher usually to the nearest degree minute.

EndLongitude

This is as recorded by the fisher usually to the nearest degree minute. Not recorded if the method does not require.

EndLatitude

This is as recorded by the fisher usually to the nearest degree minute. Not recorded if the method does not require.

StartGeneralStatAreaCode

As recorded by the fisher.

b)  Hiding a buffer 

1.        Once you have returned to the map, click on the Map Legend tab.

2.        Click on the 'User Polygon' legend item.  This will expand the legend item and give you a number of legend tools.

3.        Click on the 'Hide Buffer' legend tool.

4.        The map will refresh and the buffer will now be hidden from the map (note: the buffer is only HIDDEN, if you click 'Analyse', the data within the buffer will still remain in the analysis.

5.        Click proceed to map and you will return to the map without making any changes.

Return to top of page.

5) Other Legend Tools

 

 a) What's Here?

What's Here? can be used to find out the perimeter and area of your polygon and buffer, or to query specific points.  To change the units for linear or area measurements, select the 'Customise' tool (see Customise help for more information).

 b) Remove Layer

To remove the polygon from the map, use the 'Remove Layer' tool as you would with any other layer in NABIS.  You can also un-tick the 'User Polygon' layer within the 'Current Layers' list and click the 'Update Map' button.

 c) Data View

Data view will allow you to export and save the coordinate that you have used to create your polygon (this means that you will be able to load the same polygon again at a later date using the 'Import My Points' tool). 

  1. Click on the Map Legend tab.
  2. Click on the User Polygon legend item.
  3. Click on the 'Data View' legend tool.
  4. Click the 'Export' button to save the visible data as a .csv file (for more information see Data View Help).

Return to top of page. 

 6) Troubleshooting

 a) Error Messages  - Edit Page

 Error Message

Explanation

Title has invalid text

Title contains one of the following characters ~!@#$%^&*()+=`|\}{[]"':;?,.<>/ Remove the character and try again.

Latitude/Longitude value is invalid: Contains an invalid character

The latitude or longitude field contains an alpha character or one of the characters above.  The only acceptable characters in this field are all numbers, the letters N S E and W (at the end of the coordinate) and the symbols ° and .

Latitude value is invalid: degrees latitude must be in the range of -90 to 90

The number that has been entered is not within the valid range for a point of latitude.

Longitude value is invalid: degrees longitude must be in the range of -360 to 360

The number that has been entered is not within the valid range for a point of longitude.

Latitude (x) is outside of NZ boundary 20°S (-20) and 60°S (-60)

The latitude value is outside of what we have defined to be NZ waters - Analyse layers only works within NZ waters.  Change the coordinates to ensure that the polygon falls within NZ waters.

Longitude (x) is outside of NZ boundary 150°E (150) and 205°E (205)

The longitude value is outside of what we have defined to be NZ waters - Analyse layers only works within NZ waters.  Change the coordinates to ensure that the polygon falls within NZ waters.

 

 a) Error Messages  - Analyse Page

 Error Message

Explanation

An error has occurred on the database.  This may be because the area you have selected is too large, try reducing the size of your polygon.

The request has timed out.  The most likely reason for this is that your polygon is too large, try breaking up your area of interest into smaller polygons and try again.

The form image does not show up when the form number is clicked in the .csv file

Ensure that you have a program that reads/displays .tif files (e.g. Microsoft Office Document Imaging).

No 'Analyse Layer' option in the map legend for your polygon

The polygon you have drawn is not valid.  For a polygon to be valid, it must have 3 sides to define an area. (MINISTRY OF FISHERIES STAFF - ensure you are using the internal Ministry version of NABIS found through MFish Links or on your desktop).

Return to top of page. 

 

 7) Hints

 a) Finding the size of the both buffer and the polygon

Once you have created your buffer and returned to the map:

- Use the hide buffer tool on the legend to hide the buffer.

- Use What's here to determine the size of the polygon.

- Show your buffer using the show buffer from the legend.

- Use What's here to determine the size of your polygon and buffer combined.

- The size of your buffer is the difference between the two.