Have ideas to improve npm?Join in the discussion! »

    fly-js

    0.0.5 • Public • Published

    fly-js v0.0.5

    A JavaScript utility library focusing on aviation.

    Tests

    Test can be run eith by:

    npm test
    
    ; or
    
    mocha test
    

    Continuous Integration

    Via Github's Travis. Runs tests (mocha) and linter (jshint)

    API Reference

    Navigation functions

    fly.distanceTo(58.2, 0, 53.3, -1.2, 2);

    Returns the distance between the two pairs of decimal latitude and longitude values in nautical miles to two decimal places (last parameter).

    fly.trueCourse(53.0, 0, -9.3, 53, 2);

    Returns the initial course between the two pairs of decimal latitude and longitude values in degrees to two decimal places (last parameter).

    fly.enroute(34.6169641, 118.400009, 66, 100, 2);

    Returns a new position given true course and distance from a given point

    fly.intersectionPoint(53.583378, -0.34851, 180, 51.150837, -0.177416, 15);

    Returns the position the two great circles intersect; using the pair of latitude, longitude and course values as radials

    Convertors

    Nautical miles

    fly.nauticalMilesTo('Kilometres', 100000, 5);

    Returns 10000 nautical miles converted to Kilometres rounded to five decimal places.

    fly.nauticalMilesTo('Miles', 100000, 5);

    Returns 10000 nautical miles converted to Miles rounded to five decimal places.

    fly.nauticalMilesTo('Feet', 100000, 5);

    Returns 10000 nautical miles converted to Feet rounded to five decimal places.

    fly.nauticalMilesTo('Meters', 100000, 5);

    Returns 10000 nautical miles converted to Meters rounded to five decimal places.

    fly.nauticalMilesTo('Inches', 100000, 5);

    Returns 10000 nautical miles converted to Inches rounded to five decimal places.

    fly.nauticalMilesTo('Centimeters', 100000, 5);

    Returns 10000 nautical miles converted to Centimeters rounded to five decimal places.

    Miles

    fly.milesTo('Kilometres', 100000, 5);

    Returns 10000 miles converted to Kilometres rounded to five decimal places.

    fly.milesTo('Nautical Miles', 100000, 5);

    Returns 10000 miles converted to Miles rounded to five decimal places.

    fly.milesTo('Feet', 100000, 5);

    Returns 10000 miles converted to Feet rounded to five decimal places.

    fly.milesTo('Meters', 100000, 5);

    Returns 10000 miles converted to Meters rounded to five decimal places.

    fly.milesTo('Inches', 100000, 5);

    Returns 10000 miles converted to Inches rounded to five decimal places.

    fly.milesTo('Centimeters', 100000, 5);

    Returns 10000 miles converted to Centimeters rounded to five decimal places.

    Kilometres

    fly.kilometresTo('Miles', 100000, 5);

    Returns 10000 kilometres converted to Miles rounded to five decimal places.

    fly.kilometresTo('Nautical Miles', 100000, 5);

    Returns 10000 kilometres converted to Nautical Miles rounded to five decimal places.

    fly.kilometresTo('Feet', 100000, 5);

    Returns 10000 kilometres converted to Feet rounded to five decimal places.

    fly.kilometresTo('Meters', 100000, 5);

    Returns 10000 kilometres converted to Meters rounded to five decimal places.

    fly.kilometresTo('Inches', 100000, 5);

    Returns 10000 kilometres converted to Inches rounded to five decimal places.

    fly.kilometresTo('Centimeters', 100000, 5);

    Returns 10000 kilometres converted to Centimeters rounded to five decimal places.

    fly.mpsTo('Knots', 233, 2);

    Returns 233 miles per hour converted to Knots rounded to two decimal places.

    fly.mpsTo('KilometersPerHour', 233);

    Returns 233 miles per hour converted to km/h.

    Lookups

    Beaufort

    fly.beaufortLookup(45);

    Returns beaufort description of a 45 knot wind e.g. 'Strong Gale'

    fly.beaufortLookup(25);

    Returns beaufort force index of a 25 knot wind e.g. 6

    fly.beaufortLookup(15, 'all');

    Returns beaufort force, description and range of a 15

    Wind Cardinal Direction

    flyjs.CardinalWindDirection(180);

    Returns "S" (South) the cardinal direction for a wind at 180 degrees

    Wake (ICAO categorisation)

    fly.wakeLookup(4500);

    Returns the ICAO wake category for an aircraft of 4500kg

    Calculators

    fly.HeadWindCalculator(25, 180, 215, 2);

    Returns head wind component, given wind speed (knots), wind direction and aircraft direction (later pair both measured in degrees). Rounded to 2 decimal places.

    fly.CrossWindCalculator(25, 180, 215, 2);

    Returns cross wind component, given wind speed (knots), wind direction and aircraft direction (later pair both measured in degrees). Rounded to 2 decimal places.

    Wind Triangle

    flyjs.calculateCourseAndGroundSpeed(120, 80, 43, 133, 2);

    Returns course and ground speed, given trueAirSpeed, heading, windSpeed and windDirection, rounded to 2 decimal places.

    flyjs.calculateHeadingAndGroundSpeed(120, 60, 43, 133, 2);

    Returns heading and ground speed, given trueAirSpeed, course, windSpeed and windDirection, rounded to 2 decimal places.

    flyjs.calculateWindSpeedAndDirection(trueAirSpeed, groundSpeed, course, heading, 2);

    Returns wind speed and direction, given trueAirSpeed, groundSpeed, course and heading, rounded to 2 decimal places.

    Contributors

    One-man-band at the moment. Contact me at twitter on @rayhammond, or, via my blog here http://geeksretreat.wordpress.com if you are interest in getting involved.

    License

    MIT

    Install

    npm i fly-js

    DownloadsWeekly Downloads

    2

    Version

    0.0.5

    License

    MIT

    Last publish

    Collaborators

    • avatar