Mac post-release bug fix.
After release of the EosFit package in summer 2021, it was found that a bug in the graphics library could cause the Mac version of EosFit-GUI to crash on some Mac systems. A new version for Mac was released in October - November 2021, but is identical to the summer 2021 versions apart from this bug fix. It is necessary to re-install the entire package in order to obtain the new version of the GUI.
Mac OSX installation instructions:
- Go to the website http://www.rossangel.com
- Navigate to the EosFit software page and download the EoSFit7install_mac64.dmg
- Double-click on EoSFit7install_mac64.dmg. A finder window containing EoSFit7installer_mac64.pkg will open. Double-click on EoSFit7installer_mac64.pkg and follow the instructions to select the location where to install the program in your computer.
- After installing, the EoSFit7 a folder "EoSFit7" will be created into /Applications. The folder contains the executables, the software documentation (e.g. published manuscripts), example datasets and the manual of the program.
- EosFit7c runs as terminal-line software.
- IMPORTANT: To run EosFit7 programs additional software is required. Check if you have XQuartz software installed in your computer. If not you can download it free of charge at http://www.xquartz.org and install it following the instructions on the menu.
- Current EosFit7 Suite programs work with version 2.7.11 and later of XQuartz, but may not work with earlier versions because of library issues in XQuartz.
- If the fonts do not display correctly in the GUI, or the GUI cannot launch the calculator, follow the instructions in Known issues, below.
Running the programs:
- Run Launchpad or go to Applications folder using Finder and do a double-click on the icon.
- When you start the EosFit7 program for the first time and try to open a data file, you will have to navigate to the folder with your data.
- The examples files are installed with the programs under the /Applications folder. If you work in this area, you may not be able to write files from the programs, and the GUI may not launch the calculator. Therefore copy the examples files to a folder under your desktop and always work there.
Known issues:
- If you try to work under the /Applications folder, several aspects of the programs may not work because they do not have permission to write files. Open a data file under your desktop and then files will be created in that folder without any problems.
- On some systems the help button on the Eosfit GUI program does not work, due to a problem between the OS and the Winteracter graphics library.
- You can manually open the help system by loading the file /Applications/EoSFit7/Html/Eosfit7GUI.html into any internet browser.
- Or you can execute the following command in a terminal window:
- osascript -e 'tell application "Safari" to open location "/Applications/EoSFit7/Html/Eosfit7GUI.html" '
- On some systems there are problems with the fonts being displayed (for example, the numbers for the EoS parameters are in funny colours and not black, blue or red). To fix this problem:
- In the HOME directory of the user, check to see if a file .Xresources exists (you can use the command ls -la)
- If the file does not exist, create it with the command touch .Xresources
- Edit this file, and enter the line
- Save the file
- Close any XQuartz process (icons on toolbar)
- On some systems the installer will not set the environment variables, and then you cannot launch the calculator directly from the EosFit7GUI. To fix this problem, you must to modify your preference file according with your shell (.bashrc for bash, .zshrc for zsh, ...) to set an environment variable for EosFit:
- Check your default shell:
- From a terminal window, enter the command echo $SHELL
- Check whether the EOSFIT7 environment variable is defined:
- From a terminal window, enter the command echo $EOSFIT7
- Is you see an empty line, then you need to define the environment variable.
- Check which preference file exist in your HOME directory:
- From a terminal window, cd $HOME, then enter the command ls -la to list all files (including hidden files).
- For bash shell you should see .bashrc or .bash_profile. For zsh shell .zshrc
- Edit the .bashrc (or equivalent) file and add the following three lines:
EOSFIT7=/Applications/EoSFit7
PATH=$PATH:$EOSFIT7
export EOSFIT7 PATH
- Remember that these lines are case sensitive, so write them exactly as shown.
- Save the file
- Execute