highcanfly-club / cfdtrackjoiner

Technology demonstrator for joining FIT and IGC files for the new french "CFD Marche et Vol" developed by High Can Fly parapente https://www.highcanfly.club for FFVL

CFDTrackJoiner

Technology demonstrator for joining GPX, FIT and IGC files for the new french "CFD Marche et Vol". This project is maintained by High Can Fly | Club de parapente du Nord. If you want to help us, your help is welcomed. If you want to take your paraglider license with us take a tour on our website, there is a link for getting it.

Limitations

This is a pre-alpha version sort of a technology demonstrator.

Today it is only tested with FIT files coming from a Garmin® Fēnix 6x Pro, Garmin® Fēnix 5s or Garmin® Fēnix 3 and IGC files coming from SkyBean® SkyDrop variometer and GPX exported from Strava®.

Currently if an interval overlap another the join is not processed.

License

Provided "as is" under MIT license.

 * IGC Parser is adapted from Tobias Bieniek's project https://github.com/Turbo87/igc-parser (MIT license)
 * FIT Parser is adapted from Dimitrios Kanellopoulos's project https://github.com/jimmykane/fit-parser (MIT license)
 * GPX Parser is adapted from Lucas Trebouet's project https://github.com/Luuka/GPXParser.js (MIT license)

Test and basic help

https://cfdmv.highcanfly.club/ the app
https://cfdmv.highcanfly.club/help the same app with the help slider open

Integration in Vue3 project

High Can Fly website integrates this project in an integrated card
see code in github
TrackJoinerComponent.vue is a symlink to CFDTrackJoiner/src/views/TrackJoinerView.vue

Deploy on Clouflare Pages

After forking this repository, you can deploy it on Cloudflare Pages

Build command: npm run build
Build output directory: /dist
Root directory: /

Vue.js v3

• Vue.js v3 code is available at the root https://cfdmv.highcanfly.club
• This project is built as a vuejs v3 template. See implentation in /src/views/TrackJoinerView.vue

Legacy sample usage

• Legacy code is still available https://cfdmv.highcanfly.club/legacy2.html

• First, you must include the required JavaScript library (jQuery) you can host them on your website or link them directly from some cdn:

  <script src='https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js'></script>

• you also need these local sources (minified):

  <script src="https://cfdmv.highcanfly.club/js/trackjoiner.js"></script>

  if you need the source files:

  <script src="https://cfdmv.highcanfly.club/js/trackjoiner-dev.js"></script>

• Second, place the two buttons for flies and for hikes and the button for the result:

  <input id="filesFly" type='file' accept='.igc,.fit,.gpx' onchange='openFile(event, trackTypes.FLY, insertDBCallback)' multiple disabled/> 
  <input id="filesHike" type='file' accept='.igc,.fit,.gpx' onchange='openFile(event,trackTypes.HIKE, insertDBCallback)' multiple disabled/>
  <input id="joinBtn" type='button' onclick='getDBasIGCString()' value="Join" disabled/>

  The openFile function will be the entry point of the process. Function insertDBCallback is the call back function called when parsing and DB insert are finished. In a minimal void process an empty function will be sufficient but something more complex will be probably necessary. For example in the provided index.hml page the call back is used for filling an html table with the current content of the DB and enabling a button for retrieving the result

  var insertDBCallback = function(){
    showHTMLTable("#parsedTable");      // Look at index.html for seeing showHTMLTable
    $('#joinBtn').removeAttr('disabled');
  };

• Third, init everything In the provided example the initialization is very simple

    initDB();                                   // Needed for preparing the database
   $(window).on('load', function() {            // Be sure to wait for all the libraries to be loaded before allowing parsing
      $('#filesFly').removeAttr('disabled');    // now the load event was fired so the buttons can be enabled
      $('#filesHike').removeAttr('disabled');
   });

• Finally, get the result!

  var getDBasIGCString = function(){
    getDBFixesRowsAsPromise().then((rows) => {
                    var igcString = igcProducer(rows);
                    // the IGC file is now in igcString variable
                    // use it as you want
                    // a more complex example is in index.html
                  }).catch((error) => {
                    console.log(error.toString());
                  });   
   };

• If you want to upload the string as a pseudo file this is a sample fuction for doing that

  simpleStringUploadAsFile('https://parapente.ffvl.fr/cfdmvAPI','file',"TEMP.IGC",igcString,"ffvl_name","ffvl_password");

  Note that on the demo page call is

  simpleStringUploadAsFile('upload.php','file','TEMP.IGC',$('#igcResult').html(),'ffvl_name','ffvl_password');

  so the content of the "igcResult" html pre tag is sent to the upload.php page. The demo is not working on GitHub pages because there is no server side processor but on my own server it works 😉.

  these function can be something like:

  var simpleStringUploadAsFile = function (uploadURL, fileFormFieldName, fileName, data,name,password)
  {
  
    var fd = new FormData();                            //works on all modern browsers
    var file = new Blob([data], {type: 'plain/text'});
  
    fd.append(fileFormFieldName, file, fileName);       //this is the <input type='file' name='file'/>
    fd.append('name',name);                             //<input type='text' name='name' />
    fd.append('password',password);                     //<input type='password' name='password' />
    //... fd.append('field_name','value');
  
    $.ajax({
      url: uploadURL,
      method: 'post',
      data: fd,
      processData: false,
      contentType: false ,
      success: function(response){$("html").html(response);}  // this is for replacing the content of the page with the POST result
    });
  }

API documentation

• Typedoc is built at https://highcanfly-club.github.io/cfdtrackjoiner/