World Scenery with Submodules

Talking about the core development, vent steam ... censoring free but no guarantee, "they" will listen.
User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Wed Apr 06, 2016 4:27 pm

Thorsten wrote:As far as I know, the reason that Martin is frustrated with FG is precisely that - a large number of people working with terragear created their own custom patches of scenery (with the characteristics outlined above, I know this because I installed a few...) and there was hardly anyone helping with the big task of creating a consistent world scenery. He said this more than once.


Now this makes some sense.
So Martin dropped the project and trashed all the customScenery (cs1) shapefiles he made because people was using them in terragear to create sceneries?

Why were there in the webpage in the first place? [Not a rethorical question]

Curiously enough, terragear is not that easy to use, it is complex to compile too. I know a handful of people capable to make a patch of terrain, and I know no-one (except before Martin and now Torsten) that can actually patch one of the flooded or underground airports (in terrasync). The same ones that have NO INTEREST in allowing patches to come into the world scenery.

Patches? divergence? More and more people learning how to use terragear and being empowered to create scenery? Adding fixes to the terrain? having multiples versions? All very welcome in my opinion.
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 1:19 am

Image

TerraGit South Hemisphere


Hi All, the Southern Hemisphere (every tile south of the Equator) is now fully available on TerraGIT, using submodules.
Current source is terrasync, on April/2016, as updates and patches from other sources had not been added yet.

https://github.com/FGMEMBERS-TERRAGIT/terraGIT

Next, I am moving North of the equator and continue progress North-bound towards Artic.

Early testers and adopters.

For early testers of the Scenery with submodules. a Brief pre-explanation

The terragit is organized such as the basic content (shared models and xml configs) are just the repository. When you clone, this content is ready. The size is about 650 MB total. No Tile is installed by default! (although I may install SanFrancisco tiles by default download to get some historical heartbreak with this system :P)

There is submodules for both Objects and Terrain. You are free to install either or both, using the git submodule strategy, but I recommend that you install both the Object and the Terrain of a given tile for a complete scenery tile installation.

example (1), lets say we want to install a 10x10 degree tile in Brazil [w070s30]

Code: Select all

git clone git@github.com:FGMEMBERS-TERRAGIT/terraGIT.git
cd terraGIT
git submodule init Objects/w070s30  #prepare the Objects of the Tile
git submodule init Terrain/w070s30 #prepare the Terrain of the Tile
git submodule update  #install


When finished, you'll get the tile and a 10x10degree part of Brazil installed :P

example (2), lets say you want to install all the tiles of latitude s10
(that is any tile in that latitude accross the globe!)
(if you already cloned, and have brazil, can skip the first two lines, obviously!)

Code: Select all

git clone git@github.com:FGMEMBERS-TERRAGIT/terraGIT.git
cd terraGIT
git submodule init Objects/*s10
git submodule init Terrain/*s10
git submodule update   #installs any tile previously init


example (3), lets say you want to install the WEST antartic circle (anything below s60), but only west of the Greenwich
[I assume you already cloned]

Code: Select all

git submodule init */w*s{6,7,8,9}0
git submodule update

init */w*s{6,7,8,9}0; means
any (both Terrain and Objects) that begins with w (west) and 6,7,8 or 9, and then 0
It is a very brief way to say the following

Code: Select all

git submodule init Objects/w*s60;
git submodule init Objects/w*s70;
git submodule init Objects/w*s80;
git submodule init Objects/w*s90;
git submodule init Terrain/w*s60;
git submodule init Terrain/w*s70;
git submodule init Terrain/w*s80;
git submodule init Terrain/w*s90;


[I assume you already cloned, and installed any given tile]
example (4) lets say you want to deinstall any east tile (east of Greenwich)

Code: Select all

git submodule deinit */e*
git submodule update


deinit */e*; means
any tile (Objects and Terrain) such as begin with e (east) must be deinit.

***
Notes


The ws 2.0 scenery is very large. It you init and update a large part of the globe, a sensible amount of hard drive may be required. If hard drive is a limitant, consider only installing the 10x10 tiles needed.
This is the FASTEST! method of installing a large portion of the globe, and exceeds in 20 times the speed of the SVN mediated transfers (terramaster and off course terrasync *where you need to fly the globe to obtain it*)

It is only slower to the infinitely faster way of terrafs, but remember terrafs is a virtual filesystem, and per se you never downloaded the files.

If you init and update a tile, git will download Objects to the .git directory. git submodule deinit does not clear those objects, and thus
1) re initing is very fast, but 2) part of your hard drive remains used.

To completely clear the harddrive and to obtain a fully empty terraGit, I recommend you delete an old copy and clone from github the super-repository again. This is more effective to release Hard-drive content than just deinit. De=init will clear directories and reduce your harddrive content too, but not fully.

Adding content to TerraGit

I will add other posts later about this exciting feature later, but as you can guess, it all begins with forking any 10x10degree tile needed to patch (if will add Terrain or Objects).
For Airport configurations (Jetways, AI traffic, Groundnets) just fork terragit super-repo, edit, and pull request.


HAVE FUN Flying and Developing, and enjoying a TRULY FREE Flightgear SCENERY

Best,
IH-COL
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 1:21 am

Important.
If using terraGIT, remember you only need to redirect the FGFS to the scenery directory

there are many ways to do this, including your favorite laucher, or the command line

Code: Select all

--fg-scenery=/path/to/terraGIT


You can disable terrasync, if you wish, and you downloaded any needed tile for a flight, but You don't need to disable terrasync, particularly if you give higher priority to TerraGit, your FGFS will use terraGIT installed scenery, OR resort to Terrasync, only when you dont install the TERRAIN tiles.

Importantly, you will see Objects in TerraGit, as needed :P
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 1:30 am

IAHM-COL wrote:This is the FASTEST! method of installing a large portion of the globe


Try it out. Those tiles install so fast that it is fully unbelivable.

Also, keep in mind, git allows branches for alternative scenerios. Example, we could have tiles with WWI Historical scenerios or have extraterrestrial Homey Airports, or have versions of airports by different people, or have them with and without OSM, just by switching a branch for the Objects.

:)

Mind just go flying... into the Antartic (cause it is now available)

best,
IH-cOL
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 1:36 am

Thorsten Renk wrote:
well all know is what FGMEMBERS excels




Arigato Samurai!
We also know what you excel in.

Best,
IH-COL
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 4:45 pm

TerraGit, the install scripts

Hi All

I just implemented the new feature on terragit, that allows users to create install scripts for their favorite region/country or set of tiles (example an user-based world tile collection)

These reside in the directories install and deinstall of the Terragit repository. The install script manages the installation whereas the deinstall script manages the deinstallation of the same set of tiles.

see:

https://github.com/FGMEMBERS-TERRAGIT/terraGIT/tree/master/install
example,

https://github.com/FGMEMBERS-TERRAGIT/terraGIT/blob/master/install/Australia

and
https://github.com/FGMEMBERS-TERRAGIT/terraGIT/tree/master/deinstall
example,
https://github.com/FGMEMBERS-TERRAGIT/terraGIT/blob/master/deinstall/Australia


HOW TO USE


It is very simple.

You first set up to use terragit by cloning the Terragit repository at
https://github.com/FGMEMBERS-TERRAGIT/terraGIT

Code: Select all

git clone git@github.com:FGMEMBERS-TERRAGIT/terraGIT.git


Then, within the repository directory, you can call any script as the following example to install Australia, Argentina, NewZealand, and deinstall Uruguay

Code: Select all

cd terraGIT
install/Australia
install/Argentina
install/NewZealand
deinstall/Uruguay


That should do.

***
Important note:
These scripts manage the installation of both Terrain and Objects as required per 10x10 degrees, not effective country boundaries. Keep in mind that deinstalling uruguay above, removes the complete Scenery tile, and thus, removes sections of Argentina and Brazil as well, per the corresponding tile! (same with installing, some area of, example Paraguay and most Chile is installed as well by Argentina Tile collection.
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
SHM
Posts: 1960
Joined: Mon Sep 14, 2015 3:32 pm
Location: India

Re: World Scenery with Submodules

Postby SHM » Thu Apr 07, 2016 4:51 pm

Nice. Will give it a try.

SHM
FG Pilot (2011-2018)
Prepar3d (2015 - 2023)
MSFS2020 (2020 - )
Image

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 4:53 pm

sure. I appreciate early adopters and testers to catch issues early

Also, keep in mind TerraGit has transfer data to Github from the south pole cap to the Equator. the North does not exist yet, and it began to transfer as we speak Northbound (first the n000 tiles and then up....)
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?

User avatar
SHM
Posts: 1960
Joined: Mon Sep 14, 2015 3:32 pm
Location: India

Re: World Scenery with Submodules

Postby SHM » Thu Apr 07, 2016 5:22 pm

The N.Hemisphere will be more difficult considering there is more land there ;)
FG Pilot (2011-2018)
Prepar3d (2015 - 2023)
MSFS2020 (2020 - )
Image

User avatar
IAHM-COL
Posts: 6455
Joined: Sat Sep 12, 2015 3:43 pm
Location: Homey, NV (KXTA) - U.S.A
Contact:

Re: World Scenery with Submodules

Postby IAHM-COL » Thu Apr 07, 2016 7:29 pm

it depends what you mean by difficult. If you mean probably slower to transfer, yeah, there's more data, not only more terrain, but also more objects. Both USA and Europe are there.

If you mean, thou harder to do... not quite.
The hardest was the first tile (e000s90). a tiny tile with basically 1 object (the pole flag)

Why? Because all scripts and methods to re-engineer terrasync in terraGIT needed to be made and tested there.
Now it is just business as usual, just computing data. And since the latitude s080, I am using parallel computing in linux (full usage of cores and threads) to bring a full latitude simultaneously.

So, from that optics, not the hardest hemisphere.
https://raw.githubusercontent.com/IAHM-COL/gpg-pubkey/master/pubkey.asc

R.M.S.
If we gave everybody in the World free software today, but we failed to teach them about the four freedoms, five years from now, would they still have it?


Return to “Core Development”

Who is online

Users browsing this forum: No registered users and 3 guests