Board index FlightGear Development Documentation

Cross Country Tutorial II - a VFR guide

Discussion of the FlightGear documentation, how it can be improved and coordination of people working on it.

Re: Cross Country Tutorial II - a VFR guide

Postby Hooray » Tue Apr 09, 2013 4:19 pm

de profundis wrote in Tue Apr 09, 2013 2:43 pm:Are these parameters restrictive to the ones that will replay the recording? For example can someone replay that recording using different weather?

Yes, in general, the recording only records aircraft-specific properties, such as position, velocities, orientation, animations etc.

Of course, since this flight has been analised in that much detail, all the info is there for anyone to go ahead and make a flight recording or take these screenshots and provide them here so they be included in the document.


You could probably further simplify recreating the flight by using the route manager and adding corresponding waypoints to it - the RM also supports custom waypoints using various "offset" combinations. Also, it does support saving and loading flight plans.

Note that this does not affect the replay/flight recorder idea - it's just about more easily finding the right place to record the flight.

Image

http://wiki.flightgear.org/Route_manager

PS: A wiki article related to your tutorial, does sound like a good idea!
Please don't send support requests by PM, instead post your questions on the forum so that all users can contribute and benefit
Thanks & all the best,
Hooray
Help write next month's newsletter !
pui2canvas | MapStructure | Canvas Development | Programming resources
Hooray
 
Posts: 11375
Joined: Tue Mar 25, 2008 8:40 am

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Tue Apr 16, 2013 1:57 pm

hello again,

there is no Route Manager for the Piper Comanche...

I haven’t been able to record a flight because FG crashes when I press “save” on the flight recording menu (should I make a proper bug report for this??).

So, until I fix or find a work-around for this, those interested in the improvement of the FG-scenery and model images used in this tutorial could refer to the document to find exactly where these screenshots are captured.

Meanwhile, there is a CONTEST going on for EyE-Candy experts... :shock:
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Tue Apr 16, 2013 2:07 pm

the latest update is up!

many of the tables and graphs look much better in v 1.61

no major change in text and content
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby stuart » Tue Apr 16, 2013 9:26 pm

Hi Michalis,

Regarding the base format, I can convert it to Latex fairly easily to at least get the basic text and images. Advanced formatting would probably need more work.

Main problem for me is finding time - I've got my finger in too many pies in FG, and as Hooray and Thorsten can attest it takes ages for me to actually get through my TODO list! It would be great if you could find someone else to do the conversion to Latex - might be worth talking to jharris1993 who is also interested in documentation updates.

Regarding license - public domain works from the US Government are GPL compatible. For other images you'll need to get explicit permission. Probably a bit of a pain but a lot of people are very generous if you explain what you want to use the image for. I'd suggest just putting together a boiler-plate email explaining what FG is, emphasising that it's a volunteer community free project.

-Stuart
G-MWLX
User avatar
stuart
Moderator
 
Posts: 1469
Joined: Wed Nov 29, 2006 9:56 am
Location: Edinburgh
Callsign: G-MWLX

Re: Cross Country Tutorial II - a VFR guide

Postby Hooray » Wed Apr 17, 2013 3:55 am

there are also some free tools / web services to automatically convert typical word formatting to LaTex - which may require a little less work hopefully.
In addition, there are MS Word/Office extensions to directly export to LaTex. All of these are free - I'd suggest to give those a try first.

Here are just a few examples (which I didn't try myself, because I don't have access to a Windows system):
http://download.cnet.com/Word-to-LaTeX/ ... 05149.html
http://www.grindeq.com/word2latex.htm
Please don't send support requests by PM, instead post your questions on the forum so that all users can contribute and benefit
Thanks & all the best,
Hooray
Help write next month's newsletter !
pui2canvas | MapStructure | Canvas Development | Programming resources
Hooray
 
Posts: 11375
Joined: Tue Mar 25, 2008 8:40 am

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Wed Apr 17, 2013 12:15 pm

stuart wrote in Tue Apr 16, 2013 9:26 pm:Regarding the base format, I can convert it to Latex fairly easily to at least get the basic text and images. Advanced formatting would probably need more work.

Thanks Stuart.
I will start getting to know and work with LaTex. Right now I have no idea what advanced formating requires and if I am able to do it. Since it's not difficult for you, could you make this basic convertion so that I get an idea of how much more formatting will be needed? Do you need the 25MB .docx and the images files for this?

stuart wrote in Tue Apr 16, 2013 9:26 pm:might be worth talking to jharris1993

I' ll do that too.

GPL:
I haven't found a way to contact SkyVector. I posted the document's link in their forum. I didn't get any reply and they erased that post. Since we are ok with the FAA material, every other source used, that I haven't got permission for it by then, could be left out from the version that will be included in the FG package. I can make the changes needed for that with alternative "free" content.
stuart wrote in Tue Apr 16, 2013 9:26 pm:...putting together a boiler-plate email explaining what FG is...

Yes, I also wanted to do that but I haven't so far because, other than the FAA's contact info, I haven't found any other's address.

Hooray, thank's for the links! Will look to them soon.

Michalis
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Wed Apr 17, 2013 2:07 pm

Image
A NOTAM affecting flying Reno direct Bishop has just been issued: http://tfr.faa.gov/save_pages/detail_3_2501.html

http://skyvector.com/?ll=38.55074305200381,-120.1580200217231&chart=301&zoom=6&plan=A.K2.KRNO:A.K2.KBIH

They say that search and resque is been conducted in the area...
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby Hooray » Wed Apr 17, 2013 2:17 pm

de profundis wrote in Wed Apr 17, 2013 12:15 pm:
stuart wrote in Tue Apr 16, 2013 9:26 pm:...putting together a boiler-plate email explaining what FG is...

Yes, I also wanted to do that but I haven't so far because, other than the FAA's contact info, I haven't found any other's address.


There used to be a wiki article (stub) for exactly that purpose, but for some reason I can no longer find it - seems that Gijs has deleted it meanwhile, but you should still be able to copy/paste things together by referring to the wiki - no need to write something from scratch.
EDIT: found a cached copy at: http://wiki.flightgear.org/images/cache ... quiry.html
This is meant to eventually become a standard inquiry for people who want to ask for permission to use copyrighted work (i.e. images, 3D models, textures etc.) with FlightGear. By writing up a standard inquiry, people can easily copy/paste, modify this inquiry and send it to the individual copyright holders of the affected work. That way, we can slowly start to have one generic text document that people can easily use to send such standard inquiries to authors of copyrighted works.
This document should preferably at least discuss the following points:
  • FlightGear, free open source, cross-platform flight simulator (link to webpage, link to wikipedia entry)
  • non commercial project, developed by dozens of volunteers (link to contributor map)
  • used by several academic institutions for scientific projects (provide examples
  • depends on contributions (i.e. source code, 3D modelling, documentation writing etc.)
  • licensed under the terms of the GNU GPL, link to GNU license text and wikipedia entry
  • explain the basics of the GPL, rights, advantages and duties
  • explain why only GPL compatible (or possibly public domain) work can be officially integrated with FlightGear
  • provide examples for community support of FlightGear (previously contributed resources)
  • provide arguments for supporting FlightGear
  • supporters will be mentioned on the FlightGear webpage and in the Thanks file
Please don't send support requests by PM, instead post your questions on the forum so that all users can contribute and benefit
Thanks & all the best,
Hooray
Help write next month's newsletter !
pui2canvas | MapStructure | Canvas Development | Programming resources
Hooray
 
Posts: 11375
Joined: Tue Mar 25, 2008 8:40 am

Re: Cross Country Tutorial II - a VFR guide

Postby jharris1993 » Thu Apr 18, 2013 1:10 am

Hooray wrote in Sun Apr 07, 2013 7:15 pm:
stuart wrote in Fri Apr 05, 2013 11:26 am:I've been thinking of splitting off the tutorials for some time, and this would fit in well with that.


jharri1993 also mentioned being interested in helping with that:
Subject: Fork manual into user guide and installation guides

jharris1993 wrote:Ref: http://www.flightgear.org/forums/viewto ... 15#p171105

In this particular article, I broached the idea of forking the manual into two major sections:
  • The "User Guide" manual. That is, all of the information about successfully using FlightGear that is not installation related.
  • "Installation Guide" manuals - there would be specific and individual manuals for each major operating system supported by FG,
    (i.e. the various 'nix flavors, Mac, Windows, et. al.)


Hey! I'm not dead yet!

At risk of sounding like a disgraced Republican President - "Let me make one thing perfectly clear. . ." I am still very much interested in the installation guide type project I mentioned before, though I will suggest that this kind of VFR tutorial, though a great idea, is outside the scope of my own idea.

Unfortunately, my time has been rather thinly spread, and - no kidding! - yesterday is the first day since I last spoke with you folks that I had the opportunity to re-run FG, and I took the opportunity to upgrade from 2.8 to 2.10.

Likewise unfortunately, the installation and configuration of FG on Windows still leaves MUCH to be desired, as FlightGear still assumes that many protected operating system folders are world-writable, (or at least "775"), which causes no end of grief.

If there is one thing I would LOVE to get through the developers skulls - at least with respect to Windows - is this:

Rule #1:
NEVER, NEVER, EVER store ANYTHING except static binaries in the system program folders. (Is there any way to make this blink red with flashing chaser lights and balloons to attract attention? :D )

If we could, somehow or other, get this done, it would make installing - and documenting! - FG on Windows sooooo much easier.

/rant :D

Thanks for letting me ramble. . . .

Jim (JR)
What say ye?

Jim (JR)

Some see things as they are, and ask "Why?"
I dream things that never were, and ask "Why Not".

Robert F. Kennedy

“Impossible” is only found in the dictionary of a fool.
Old Chinese Proverb
jharris1993
 
Posts: 139
Joined: Sun Nov 18, 2012 9:20 pm
Location: Worcester, MA. / Moscow, Russia
Callsign: $%^&ing Idiot!
Version: Whatever..
OS: Win-7 / Linux

Re: Cross Country Tutorial II - a VFR guide

Postby Hooray » Thu Apr 18, 2013 4:17 am

Likewise unfortunately, the installation and configuration of FG on Windows still leaves MUCH to be desired, as FlightGear still assumes that many protected operating system folders are world-writable, (or at least "775"), which causes no end of grief.

fair enough - we do have a "lessons learned" section in the wiki where we specifically ask for that sort of feedback: http://wiki.flightgear.org/Release_plan#2.10
And also an issue tracker: http://flightgear-bugs.googlecode.com/

These are the most reliable means to report issues and ensure that they won't be getting lost.
Please don't send support requests by PM, instead post your questions on the forum so that all users can contribute and benefit
Thanks & all the best,
Hooray
Help write next month's newsletter !
pui2canvas | MapStructure | Canvas Development | Programming resources
Hooray
 
Posts: 11375
Joined: Tue Mar 25, 2008 8:40 am

Re: Cross Country Tutorial II - a VFR guide

Postby chris_blues » Wed Apr 24, 2013 9:47 am

I've spotted some error on page 21! There's a red box above the text on the right...
Image
Nice Tutorial! Thanks!
Don't hesitate to let me know if I'm incorrect or just annoying! As long as you do it gently! :)
Debian testing 64bit - Athlon II 2x2.6GHz - 8GB RAM - GeForce GTS 450
Citation II
User avatar
chris_blues
 
Posts: 1539
Joined: Mon May 03, 2010 1:30 pm
Location: claws of real life
Callsign: chris_blues
Version: GIT
OS: Debian 8 64

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Fri Apr 26, 2013 9:04 am

we got to v 1.99

that's four updates in less than a month...

there is a changelog now (see first post on the thread).
chris_blues wrote in Wed Apr 24, 2013 9:47 am:I've spotted some error on page 21!

I will take care of this nasty red box being nowhere near it should be, thanks.
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby de profundis » Fri May 31, 2013 9:30 am

Attention all Airmen:

the FlightGear Cross-Country Tutorial II - a VFR guide

has reached 2.0 status
after being enhanced with spectacular in-game screenshots
provided by
chris_blues

the link for 2.0 is in the opening post of this thread

dp
Cross Country Tutorial II - a VFR guide all that's VFR and more...!
de profundis
 
Posts: 65
Joined: Fri Jun 08, 2012 2:18 pm
Location: Greece
Callsign: SX-ATM M-J4MC
Version: 3.4
OS: 8

Re: Cross Country Tutorial II - a VFR guide

Postby F-JYL » Fri May 31, 2013 10:08 am

Thank you for this great work !
F-JYL
 
Posts: 54
Joined: Mon Mar 11, 2013 8:34 pm
Callsign: F-JYL
Version: git
OS: Ubuntu 13.10

Re: Cross Country Tutorial II - a VFR guide

Postby jharris1993 » Fri May 31, 2013 2:05 pm

Wow!

Can't nobody accuse you folks of being asleep at the wheel, 'eh?

When I get two seconds to rub together, I'm a-gonna have to download that and take another look. It was awesome before, I can't even imagine what it must be like now!!
What say ye?

Jim (JR)

Some see things as they are, and ask "Why?"
I dream things that never were, and ask "Why Not".

Robert F. Kennedy

“Impossible” is only found in the dictionary of a fool.
Old Chinese Proverb
jharris1993
 
Posts: 139
Joined: Sun Nov 18, 2012 9:20 pm
Location: Worcester, MA. / Moscow, Russia
Callsign: $%^&ing Idiot!
Version: Whatever..
OS: Win-7 / Linux

PreviousNext

Return to Documentation

Who is online

Users browsing this forum: No registered users and 0 guests