co.uk.wxApp.models

Class Library

java.lang.Object

co.uk.wxApp.models.Library

public class Library
extends java.lang.Object

A library of static methods used by this app

Author:

Ben Lee-Rodgers

Constructor Summary

Constructors

Constructor and Description
Library()

Method Summary

Methods

Modifier and Type	Method and Description
static int[]	citySorter(double[] lats, double[] lngs) Takes a collection of nine cities and sorts them NW to SE, so that on a 3x3 grid they appear in roughly the correct relative positions according to their co-ordinates.
static void	copyFileFromAssets(java.lang.String asset, java.lang.String destination, android.content.Context ctx) Copies a file from the assets folder to an internal destination Modified from textbook - Beginning Android 4 Application Development, Wei-Meng Lee - 2012
static java.lang.String	dateFormat(java.lang.String time) Formats a timestamp for use by this app
static int[]	getOrdersFromSort(double[] array) Get the mapping from a sorted array to its original, unsorted state
static int	indexFind(double[] array, double value) My version of Java's Arrays.indexOf().
static java.lang.String[]	readWebpageToArray(java.lang.String url) Stores the contents of a text file from a URL into an ArrayList of Strings
static int	readWebpageToInt(java.lang.String url) Gets an integer from a webpage
static int[][]	splitArray(int[] array) Split an array of length 9 into a 2D, 3x3 array
static int	valueColour(double value, int type) Converts a raw weather variable value to a relative one to be used for accessing an array index ( whereby the array specifies a colour spectrum ).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Library

public Library()

Method Detail

readWebpageToArray

public static java.lang.String[] readWebpageToArray(java.lang.String url)

Stores the contents of a text file from a URL into an ArrayList of Strings

Parameters:

url - from the web

Returns:

an ArrayList of Strings, one per line of the text file; empty array on failure

readWebpageToInt

public static int readWebpageToInt(java.lang.String url)

Gets an integer from a webpage

Parameters:

url - from the web

Returns:

the raw number, or -1 on failure

copyFileFromAssets

public static void copyFileFromAssets(java.lang.String asset,
                      java.lang.String destination,
                      android.content.Context ctx)
                               throws java.io.IOException

Copies a file from the assets folder to an internal destination Modified from textbook - Beginning Android 4 Application Development, Wei-Meng Lee - 2012

Parameters:

asset - the filename of the file in the assets folder

destination - the full destination file path

ctx -

Throws:

java.io.IOException

dateFormat

public static java.lang.String dateFormat(java.lang.String time)

Formats a timestamp for use by this app

Parameters:

time - a UNIX timestamp in seconds

Returns:

a textual representation of the timestamp

valueColour

public static int valueColour(double value,
              int type)

Converts a raw weather variable value to a relative one to be used for accessing an array index ( whereby the array specifies a colour spectrum ).

Parameters:

value - the raw value in native (UK) units

type - the weather variable type:
0 - Temperature
1 - Rainfall
2 - Wind speed
3 - Humidity
4 - Pressure

Returns:

the variable-independent relative value

indexFind

public static int indexFind(double[] array,
            double value)

My version of Java's Arrays.indexOf(). Mine works on doubles, Java's does not.
Finds the index of a double in an array, or -1 if not found.

Parameters:

array -

value -

Returns:

getOrdersFromSort

public static int[] getOrdersFromSort(double[] array)

Get the mapping from a sorted array to its original, unsorted state

Parameters:

array - unsorted

Returns:

mapping

splitArray

public static int[][] splitArray(int[] array)

Split an array of length 9 into a 2D, 3x3 array

Parameters:

array - the 1D array

Returns:

the 2D array

citySorter

public static int[] citySorter(double[] lats,
               double[] lngs)

Takes a collection of nine cities and sorts them NW to SE, so that on a 3x3 grid they appear in roughly the correct relative positions according to their co-ordinates.
They are first sorted by longitude, then within each group of three sorted by latitude.

Parameters:

lats - latitudes of the cities

lngs - longitudes of the cities

Returns:

the orders of the sorted cities according to a 3x3 grid: W to E, N to S.