17
1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open the application 2. How to compare the sizes of many newborns to the standards 3. How to compare the size of a single newborn to the standards 4. How to troubleshoot

International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

  • Upload
    others

  • View
    0

  • Download
    0

Embed Size (px)

Citation preview

Page 1: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

1

International Newborn Size at Birth Standards: Application

March 2017

User guide

Contents

1. How to install and open the application

2. How to compare the sizes of many newborns to the standards

3. How to compare the size of a single newborn to the standards

4. How to troubleshoot

Page 2: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

2

HOW TO 1. INSTALL AND OPEN THE APPLICATION

WHERE CAN I FIND THE APP AND HOW DO I INSTALL IT? The International Newborn Size at Birth Standards application can be on the INTERGROWTH-21st website on the Global Health Network: https://intergrowth21.tghn.org/standards-tools/ or http://bit.ly/IG21Tools. The application is available in 3 formats: for Windows, for Apple Mac and an online browser-based version, which requires internet connection. If you choose to download the application, it should by default be saved in the “Download” folder (unless you changed your preferences). Once downloaded, proceed to install the application. On Windows Double-click on “INTERGROWTH-21st.msi”

Click “Run”

Click “Next”

Page 3: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

3

Click “Next”, again

Then click “Install”

A screen will appear and your computer will ask permission to install the program. Click ‘Yes’

Once the installation is finished, click ‘Finish’

An icon will appear on your desktop.

Note that other versions of Windows may differ slightly.

Page 4: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

4

On an Apple Mac Go to the “Download” folder, select and open the “Intergrowth 2017-02-17 11-14-37” file (the name of the file may change for more recent versions of the application). The computer will unzip the file.

Once installed, you can (1) move the app to the “Launchpad” or (2) pin it in the “Dock” or (3) create a shortcut on the desktop. When you open the application, the INTERGROWTH-21st application icon will appear in the dock. The app can be used by clicking on this icon.

Page 5: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

5

HOW TO OPEN THE APPLICATION For Windows 7 and above Open the INTERGROWTH-21st application

For previous versions of Windows Click on the icon on the desktop or Click on the “Start” icon at the bottom left of your screen. Go to “All programs”, then “Oxford University” folder and select the INTERGROWTH-21st Standards for Size at Birth application from the list.

On an Apple Mac Click on the application icon to open it. The application can be found on the Launchpad, dock bar or desktop, depending on how you set it up.

Page 6: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

6

DESCRIPTION OF THE APPLICATION

The application first opens on its home screen. The home screen is divided into 3 panes:

- On the upper right pane, there is a brief description of the INTERGROWTH-21st

Project and a link to the Project’s website

- On the lower right pane, you will find 2 tabs “Newborns” and “Very preterm”, which

contain links to the tables of centiles and z-score values for weight, length and head

circumference

- On the left pane, you will find options to enter data manually or upload the file

Home screen

Page 7: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

7

The menu bar at the top of the home screen has 3 options:

1. “About” takes you back to the home screen

2. “Language” offers the user a language option (English, Portuguese or Spanish) to

operate the app. Choose the appropriate one for you

3. “Help” takes you to the help screen where you can find instructions on how to

format your data correctly as well as an email address to contact us if you encounter

any problems

The application is ready to use!

Page 8: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

8

HOW TO 2. COMPARE THE SIZES OF MANY NEWBORNS

TO THE STANDARDS WHAT THE APP CAN DO FOR YOU The application allows you to upload a *.csv or *.txt file with biometric data for an unlimited number of newborns (as an input), and download a file with z-scores and centiles for all biometric data (as an output). HOW TO PROCEED

1. Prepare your data The easiest way to proceed is to create a file in Excel according to the instructions in the Table and the examples presented below.

Column ID Gender Gestational age Biometric data

Header ID Sex GA Weight Length Headcircumference

Content Any alphanumerical identifier

Male / Female Other terms (e.g. boys / girls or M / F) will not work.

Integer number without decimals in days Range: 24+0 to 42+6 weeks’ gestation, i.e. 168 to 300 days

Weight should be in kg with up to 3 decimal places Length and head circumference in cm with up to 1 decimal place

Comment Not compulsory, the app will present results in the same order as they appear in the original file

Compulsory Compulsory Not compulsory for head circumferencce, the 2 words need to be joined with no space

The column headings are not case-sensitive and their order is not fixed; other columns can also be present. What is important is that the headers appear as presented in the red box.

Page 9: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

9

For the biometric data, decimals can be separated by either a comma or decimal point (e.g. “2,5” or “2.5”)

2. Save your file

The application supports both *.csv and *.txt format. Save your Excel file as *.csv

File Save as Choose the location of your file Enter the file name Choose the *.csv

format from the dropdown menu Press “Save”

Do not save your file directly from Excel to *.txt. If you do so, the resulting *.txt file will be

tab delimited and the application only supports *.txt files using a comma or a decimal point

Page 10: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

10

as separators. An error message will appear when you try to upload your file (see

Troubleshooting section, 3)

Once saved, close your dataset.

3. Open the application If not already open, see previous section on where to find and how to open the application on your computer.

4. Upload your file

Either drag and drop your file to the dedicated zone as follows (Note that the “drag and drop” option only works for *.csv files)

Or use the “Browse” button on the application

Page 11: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

11

Locate and select your file. Click ‘Open’

At this point, the app will automatically calculate and display the results

Page 12: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

12

5. Read the data The app displays “N/A” (Not Applicable) in the result pane:

- For a whole line if either gender, GA or both are missing (lines 2 and 3) - For a specific measurement, if no data were present in the file (lines 4, 5 and 6)

6. Export the data Click the “Export” button on the top right corner of the result pane. Then select a location for your file, enter a name, and click Save. The exported file is a *.csv with new z-score and centile columns for each measure (birthweight, length and head circumference). Results can also be directly copied and pasted from the application.

7. Compare a new batch of data To upload a new *.csv or *.txt file for comparison with the standards, first remove the previous file by clicking on the trash bin icon. Then start again from step 3.

Page 13: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

13

HOW TO 3. COMPARE THE SIZE OF A SINGLE

NEWBORN TO THE STANDARDS WHAT THE APP CAN DO FOR YOU The application allows you to enter data (birthweight, length, and head circumference) manually for one newborn at a time (as an input), view the results in the application (both z-scores / centiles and graphically), and directly download a *.pdf file of the results. HOW TO PROCEED

1. Select manual entry mode When you are on the home screen, click on the radio button “Enter data manually”. This will toggle from Data batch upload to Manual entry.

2. Enter data manually

1. Select “Newborn Sex”

2. Select gestational age in weeks and days

3. Enter at least one of the 3 measurements

4. Click “Compare to standards”

5. Click “Export” to save a *.pdf document of your data

Page 14: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

14

3. Look at the results and graph

You can navigate between measurements by choosing their tabs and choose between z-score and centiles. You can also zoom in and out.

Page 15: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

15

4. Export and print the data Click on “Export” to download automatically a *.pdf file containing the results and graphs

for each measurement.

Example of output – here “Length”:

Page 16: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

16

HOW TO 4. TROUBLESHOOT

1. I cannot upload drag and drop my file. What should I do?

The application allows only *.csv files to de dragged and dropped directly. Files with a *.txt extension can only be uploaded through the “browse” function. First make sure that your data are in a *.csv or *.txt file. Note that data in *.txt file should be separated by a comma or semicolon and not tab delimited.

2. I cannot find my file. What should I do? If when you try to upload a file using the “Browse” function, you cannot find your data file, make sure that it is saved in a supported format, i.e. *.csv or *.txt

3. My file is in the correct format but when I upload it, I see an error message. If you are certain that your file is in the correct format but when you upload your file, the application still displays the following error message:

Make sure your file is closed before trying to upload it. If not, close it and try again.

Page 17: International Newborn Size at Birth Standards: Application...1 International Newborn Size at Birth Standards: Application March 2017 User guide Contents 1. How to install and open

17

4. When I upload my files, the results are “N/A”? If N/A appears, it may mean:

1. A compulsory piece of information, like gender or gestational age, is either missing or has not been entered in the correct format. Please refer to the “Prepare your data” section.

2. The column has not been correctly labelled. Please refer to the “Prepare your data” section.

3. The measurement is missing from your file

Example of screen when compulsory information is missing (e.g. no data in the Sex or GA columns or the columns have been omitted) or the data are present but not in the correct format (e.g. there are decimals in the values for GA or you used “boys” and girls” instead of “male” and “female” for sex):

Example of screen when either a measurement has been omitted (here, Length) or your column has been incorrectly labelled (e.g. “Lenght” instead of “Length”):

5. I have tried everything and nothing seems to be working, what shall I do? If you encounter further problems and cannot find a solution in this section, please contact us by email at [email protected]. Please state the nature of your problem(s) in detail (send screen shots if necessary) and include a sample or all of your data. We will check the data for you and give you feedback as soon as possible.