After downloading and unzipping the file, how can I start the software?
Thank you for your message.
There are two different cases:
case (i): You have downloaded the source code, which requires compilation using Xcode on mac.
Clicking on the file FGBASE.xcodeproj inside the directory FGBASE_sep2014 will open the project in Xcode
Then clicking on “Run” will compile and run the application.
case (ii): You have downloaded the precompiled binary.
Clicking on FGBaseApp will start the application. Your operating system has to be MAC OSX 10.6 or 10.7 or 10.8.
In both cases (i)&(ii) the application will look for the data it should use in
( ~ denotes the user’s home directory i.e. /Users/user_name/ )
You must put the data you wish to use there so that the application can find it.
this step is described on the page https://www.fgbase.org/user-data/
I have just added a dataset containing fictitious case-control which you can use for testing purposes.
(You can download it on the page https://www.fgbase.org/user-data/)
To summarize it is important that the data for the application be put in the directory
Please let me know if this works for you, and if not, what error messages you encounter.
I placed the data in the Application Support/FGBASE folder. When I open the app, I notice that the entities classes are not defined/associated. Does this occur automatically or require user intervention? If so, how?
Also, do you plan on creating a short manual or documentation?
Thank you for your very well written blog article.
Are you using the sample data set? With it do the entities classes appear as not defined/associated?
The documentation is at the moment indeed somewhat limited (https://www.fgbase.org/user-data/ and the International Journal of Health Geographics article). I hope to get some feedback from users and then write a manual and documentation according to their interests and needs. I also hope that some users will want to read the source code and add extensions and modifications.
Yes, I am using the sample data. I boxed in the message window which says the entities are classless.
Here is a link to a screenshot, FYI:
Thanks again for your contribution to the open source community!
The application handles both entities grouped into classes, and classless entities which do not belong to classes.
From the screenshot, what has been loaded are the 1,144,774 classless entities.
These are loaded from the file entities.grid located in ~/Library/Application\ Support/
In the sample data, these classless entities consist of locations of vineyard land cover and appear in green on the map. The area around Bordeaux will display many of these classless vineyards entities.
The application also handles application which are grouped into classes. These data can be large and are not automatically loaded by the application. To load these, the user must select “Load classes of entities” from the data menu on the top of the screen. This will load the classes of entities from the 3 files located in ~/Library/Application\ Support/classes_of_entities/ .
I am realizing that this application really does need a manual. Since releasing it, I have finished the job (postdoc) where I developped it and moved to another postdoc where the focus is on statistical genetics, and not spatial epidemiology. I hope to take a week or so during my next vacations and write a manual.
Comments are closed.