Geant4 Installation Guide

Contact me: geant4.toolkit.zabihiATgmail.com

GEANT4 installation on Ubuntu

There are several ways to install Geant4 on your computer. Which one is available or best for you depends on both your operating system and usage requirements. In all cases, always use the most recent Geant4 release to ensure use of the latest bug fixes, features, and help the developers and community to provide quick user support. Here, I describe my way:)

To install Geant4 there are several steps. Just follow them carefully.

Step 1 – Update and Upgrade :

First of all, you must update and upgrade your Ubuntu platform. For doing that, it's better to change Ubuntu update center's setting. So  follow bellow steps: 

•  Search ''update'' on Ubuntu's search engine and then select ''software updater'' then choose setting. In the first tab of setting page , change ''download from'' from ''server for your country'' to ''main server'' and also tick the check marks like bellow figure. Untick (deselect) “restricted” parts.

• In the next tab (other softwares) just tick the ''source code''s and deselect all other parts. Then close the window.

Now enter commands in terminal for updating and upgrading platform  and wait to complete the process.

•  sudo apt-get update
• sudo apt-get upgrade

Step 2 – Software Required to Build Geant4

Enter bellow commands in terminal one by one and wait to complete (Be sure have seen "done" for each one).

Note: pay attention about the probable error and notification, all of the processes should be finished correctly. 

*  sudo apt-get install g++ 

*  sudo apt-get install  libxmu-dev 

*  sudo apt-get install  freeglut3-dev

*  sudo apt-get install  mesa-common-dev

*  sudo apt-get install  mesa-utils

*  sudo apt-get install  libglu1-mesa

*  sudo apt-get install libgl1-mesa-dev

*  sudo apt-get install  libgl1-mesa-dri

*  sudo apt-get install  libxi-dev 

*  sudo apt-get install  libxerces-c-dev

*  sudo apt-get install expat 

*  sudo apt-get install libexpat-ocaml

*  sudo apt-get install libexpat-ocaml-dev 

Step 3 –  install CMake 3.3 or higher.

Geant4 uses CMake to configure a build system for compiling and installing the toolkit headers, libraries and support tools.  In this step we must install CMake compiler on our platform. First go to cmake page and download the Uinx/Linux Source with .tar.gz format. (Source distributions:)

Then unpack downloaded file and copy the folder in your home page or any directory you want. Now open cmake folder and open terminal in the same folder (directory). Then write three bellow commands one by one. Wait to complete the configuring and making installation. When configuring complete you must face with comment like this: ''CMake has bootstrapped. Now run make'' 

• ./configure (If  the downloaded file is complete, just type two frist letters then click the tap key. It must be filled out)
• make -j6 (6 is number of core  of your system)
• make install

NOTE: When you enter this command and face with an error which said , cmake couldn't make a folder in a certain path because it became denied by ubuntu , use bellow command in each path to make it possible to create folders in that path. Or just add sudo before make or make install 

• sudo chmod ¬R 777 /path

Step 4 –  install QT

Just type on your terminal:

 sudo apt-get install qtdeclarative5-dev qml-module-qtquick-controls

Step 5 –  install GEANT4

First go to  geant4 homepage and download source file and data files. 

After download, just extract source file and leave data files compact and then copy both folder (data and geant4-source) to ''/usr/local/include/'' . Before copying the files, please type this command on terminal

• sudo chmod ¬R 777 /usr/local/include/

Then create a build folder beside your source folder. Finally, you would have three folders (data – geant4-source – geant4-build)
Now go to this path "/usr/local/include/geant4-source/cmake/Modules". Then find and open  ''Geant4InstallData.cmake'' file and press Ctrl+F and type '' cern '' to find a CERN's URL. Now delete the URL (as follow)
set GEANT4_DATASETS_URL  http://geant4.cern.ch/support/source 
Now replace the data folder's path :
set GEANT4_DATASETS_URL     /usr/local/include/data/
Save the file and  go back to geant4-build and right-click and select open in the terminal and then enter following commands:

cmake -DCMAKE_INSTALL_PREFIX=/usr/local/include/geant4.10.07_install 

/usr/local/include/geant4.10.07_source

 -DGEANT4_INSTALL_DATA=ON

-DGEANT4_INSTALL_EXAMPLES=ON

-DGEANT4_USE_OPENGL_X11=ON

-DGEANT4_USE_GDML=ON 

-DGEANT4_USE_RAYTRACER_X11=ON

  -DGEANT4_BUILD_MULTITHREADED=ON

 -DGEANT4_USE_QT=ON


This is the installation path (will create once installation done): /usr/local/include/geant4.10.07_install    
And this is the source path:  /usr/local/include/geant4.10.07_source 

Replace 'geant4.10.07' with your version.
Note: pay attention to see  ''configuring done''

Then type:

    • make ­-jn

If your computer has n core you should enter n after j. The last command for installing geant4 is mentioned here:

    • make install

Step6 –  Configuring the Environment

Go to Home page on your computer and unhidden files in this directory by pressing Ctrl+H and then open '' .bashrc '' file and copy these two commands at the end of these text files and save it:

source /usr/local/include/geant4.10.07/bin/geant4.sh

source /usr/local/include/geant4.10.07/share/Geant4-10.7.2/geant4make/geant4make.sh

Check the exact directory with your system.

Step7 –  Run an example

To run a project  first go to example's directory in 

 /usr/local/include/geant4.10.7_install/share/Geant4­10.7

 and copy'' examples'' folders in home page. Now open example in home directory an then choose one of three folders (Basic/B1 )

Then  create a Build folder inside the B1 folder. Go to the Build folder and open terminal and type:

cmake ..

then

make -jn

then

./exampleB1

Download PDF  file (Geant4 Installation Guide).

Tutorial on Geant4 for users interested to begin or improve their usage of Geant4:  25-31 May 2021 CERN

Geant4 First Steps Course:  John Apostolakis

Geant4 Advanced Course 2021 @ CERN

the Fourth Geant4 International User Conference 2022

Google it:      geant4 site:videos.cern.ch

نصب Geant4 در ویندوز

برای نصب Geant4 در ویندوز می توانید از این فایل که دوستی (خانم آرایش نیا)  تجربه ش را داشته اند و به اشتراک گذاشتند، استفاده نمایید. من خودم تجربه ای ندارم.

 دانلود فایل  نصب جینت ۴ در ویندوز

راهنمای اجرای مجازی Geant4

راهنمای اجرای مجازی Geant4

برای شروع کار با ابزار Geant4 استفاده از این روش پیشنهاد می گردد.  فرآیند نصب  زمان کمتری نیاز دارد و بسیار آسان تر از نصب واقعی آن در محیط لینوکس است. فقط باید یک اینترنت پرسرعت برای دانلود فایل اصلی داشته باشید و کمی حوصله!

• ابتدا آخرین نسخه‌ی VMware Workstation Player  را دانلود و نصب کنید.
• سپس از آدرس لینک  گزینه دوم یعنی G4.10.5_CentOS7_us را دانلود کنید.
• حال از داخل سیستم مجازی، برنامه   G4.10.5_CentOS7_us را  مطابق شکل 1 و 2 اجرا کنید، سپس منتظر بمانید تا سیستم لود شود. می ‌توانید با کلیک راست روی G4.10.5_CentOS7_us و  انتخاب setting برنامه،  ram و ... اختصاص داده به اجرای مجازی را افزایش دهید.

شکل 1 

 شکل 2

• اگر با خطای شکل 3 مواجه شدید از آدرس زیر به قسمت بایاس سیستم بروید  و روش ارائه شده در این لینک را اجرا کنید.

شکل 3

• حال ابتدا گزینه home  را از  desktop انتخاب کنید و از قسمت آخرین گزینه‌ی منوی  سمت چپ، other locations و سپس computer را انتخاب کنید.
• سپس از آدرس /usr/local/geant4.10.05/share/Geant4-10.5.0/examples مثال ها را به home  یا desktop سیستم منتقل کنید.
• روش اجرای مثال شبیه‌ی نسخه واقعی است، فقط باید در قسمت اول آدرس دهی دستور cmake عبارت زیر را وارد کنید: cmake -DGeant4_DIR=$G4COMP 

نصب Geant4

نصب geant4 بر روی سیستم عامل لینوکس

نصب پیش‌نیازها

1. ابتدا سیستم عامل را با دستورات زیر آپدیت و آپگرید نمایید:
2.  sudo apt-get update و sudo apt-get upgrade
3. سپس کتابخانه‌های مورد نیاز را نصب کنید.
4.  پیشنهاد می‌دهم هر برنامه را جداگانه نصب کنید تا از نصب تک تک کتابخانه‌ها مطمئن شوید. زیرا نصب نشدن هر کتابخانه مساوی است با دیدن خطایی خاص هنگام نصب برنامه!
5.  همچنین اگر برای نصب هر کتابخانه خطایی مشاهده کردید با جستجو در انجمن‌های معرفی شده حتماً راه حل مناسب را خواهید یافت. 
6. می‌توانید در قسمت نظرات هم خطای خود را اعلام بفرمایید. 

• sudo apt-get install g++ 
• sudo apt-get install  libxmu-dev 
• sudo apt-get install  freeglut3-dev
• sudo apt-get install  mesa-common-dev
• sudo apt-get install  mesa-utils
• sudo apt-get install  libglu1-mesa
• sudo apt-get install libgl1-mesa-dev
• sudo apt-get install  libgl1-mesa-dri
• sudo apt-get install  libxi-dev 
• sudo apt-get install  libxerces-c-dev
• sudo apt-get install expat 
• sudo apt-get install libexpat-ocaml
• sudo apt-get install libexpat-ocaml-dev 

• نصب cmake نسخه 3.5 به بالا
•  از سایت سی میک   نسخه مرتبط به لینوکس  Uinx/Linux Source با فرمت  tar.gz. را دانلود کنید.
• سپس آن را  extract کنید.
• حال در فولدر برنامه ترمینال را در همان آدرس باز کنید و دستور  configure/.   را وارد و اجرا کنید.  اگر فایل درست دانلود شده باشد، با نوشتن حرف اول دستور و زدن کلید tab باید دستور کامل شود.
• سپس make  کنید. (دستور make  را در ترمینال وارد کنید.)
• در نهایت make install  را وارد کنید. 
• اگر هنگام نصب برنامه با خطای دسترسی به مسیر نصب مواجه شدید  عبارت sudo  را قبل از دستور اصلی وارد کنید و  نصب برنامه را پیش ببرید.

دانلود Geant4

•  آخرین نسخه را از منوی سمت راست سایت اصلی دانلود کنید.
• سعی کنید نسخه بتا را دانلود نکنید.
•  پیشنهاد می‌شود حتماً از یک نرم افزار دانلود برنامه مثل Internet Download Manager  استفاده کنید. زیرا ممکن است فایل ها به طور کامل دانلود  نشوند.
• فایل‌های زیر را دانلود کنید.

نصب Geant4

• گرافیک برنامه
• اگر برای دیدن گرافیک برنامه علاقمند به دیدن تصاویر سه بعدی هستید پیشنهاد می‌شود Qt را نصب کنید. 
• البته برنامه‌های دیگری را تیم اصلی پیشنهاد داده است که به فراخور نیازتان می‌توانید آنها را انتخاب کنید. 
• برنامه qt  را باید قبل از نصب Geant4، با دستور زیر در ترمینال نصب کنید:

 sudo apt-get install qtdeclarative5-dev qml-module-qtquick-controls

• این لینک و این لینک   را ببینید.

• نصب Geant4
• پیشنهاد می‌شود مسیر نصب را /usr/local/include/ انتخاب نمایید. ( ابتدا گزینه home  را از  desktop انتخاب کنید و از قسمت آخرین گزینه‌ی منوی  سمت چپ، other locations و سپس computer را انتخاب کنید. حال فولدر usr را پیدا کنید و ...)
• با نوشتن دستور sudo  chmod  ­-R  777 /usr/local/include در ترمینال،  دسترسی به این مسیر برای نصب و اجرای برنامه‌ها به وجود خواهد آمد.  در غیر این صورت حین اجرای مثال ها با مشکل مواجه خواهید شد.
• همه‌ی فایل‌های دیتا (تصویر دوم دانلودها) را در این مسیر و در فولدری به نام data  قرار دهید. نیازی به extract کردن آنها نیست.
• فایل سورس برنامه (تصویر اول دانلود) را هم در این مسیر و کنار فولدر data   قرار دهید. البته باید آن را  extract  کرده باشید.
• به اسم فولدر برنامه source_  اضافه کنید که حین نصب برنامه برایتان مشخص باشد.
• یک فولدر با نام build در کنار data و source برنامه بسازید تا نصب را در آن فولدر ادامه دهید.
• حال به مسیر زیر بروید: /usr/local/include/geant4­-10-3_source/cmake/Modules
• فایل Geant4InstallData.cmake را پیدا کنید و در آن با ctrl+f عبارت cern را جستجو کنید تا عبارت زیر را بیابید: 

set GEANT4_DATASETS_URL  http://geant4.cern.ch/support/source

• حال به جای آدرس سایت سرن محل قرارگیری فایل data خودتان را جایگذاری کنید. یعنی /usr/local/include/data/
•  با این کار به جای دانلود مستقیم از سایت سرن و نیاز به اینترنت و ... دیتاها از روی سیستم خودتان خوانده خواهد شد.
• حال به فولدر build بروید و ترمینال را در آن آدرس باز کنید. سپس عبارت زیر را در آن وارد کنید و کلید inter را بزنید.

cmake -DCMAKE_INSTALL_PREFIX=/usr/local/include/geant4.10.03          /usr/local/include/geant4.10.03_source -DGEANT4_INSTALL_DATA=ON -DGEANT4_INSTALL_EXAMPLES=ON -DGEANT4_USE_OPENGL_X11=ON -DGEANT4_USE_GDML=ON -DGEANT4_USE_RAYTRACER_X11=ON  -DGEANT4_BUILD_MULTITHREADED=ON -DGEANT4_USE_QT=ON

• آدرس اول /usr/local/include/geant4.10.03  محل نصب برنامه است و آدرس دوم /usr/local/include/geant4.10.03_source محل قرارگیری سورس برنامه است. می‌توانید به آدرس اول یک پسوند Install اضافه کنید تا برایتان واضح‌تر شود.
• اگر پیش نیاز qt را نصب کرده‌اید می‌توانید GEANT4_USE_QT=ON- را در cmake باقی بگذارید. با این کار برنامه گرافیکی شما قابلیت‌های خوبی را برای نمایش گرافیک خواهد داشت.
• اگر این دستور را در این مرحله وارد نکنید برنامه گرافیکی شما برنامه ساده opengl خواهد بود.
• با  قرار دادن  DGEANT4_BUILD_MULTITHREADED=ON-  در دستور نصب قادر خواهید بود با دستوراتی در برنامه‌‌هایتان همه core های سیستم را در حین اجرای برنامه درگیر کنید.
• بعد از اتمام این مرحله، make را در ترمینال وارد کنید. با نوشتن  make -j5 در حین اجرای برنامه مثلاً 5 هسته سیستم درگیر خواهد شد و فرایند نصب سریع‌تر پیش می‌رود.
• این مرحله زمان بیشتری نسبت به مراحل دیگر نیاز دارد.
• پس از اتمام این مرحله،  make install را در ترمینال وارد کنید. 
• قاعدتاً نباید مشکل و خطای دسترسی ببینید. با نوشتن عبارت sudo  قبل از دستور بالا، این مشکل رفع خواهد شد.  (حتماْ حواستان باشد که باید دستور sudo  chmod  ­-R  777 .... را قبل از شروع فرآیند نصب زده باشید و دیدن خطا در این مرحله می تواند به دلیل فراموش کردن وارد کردن این دستور باشد.)
• در مرحله آخر نصب باید در home سیستم عامل تان،  با  کلید ترکیبی ctrl+h فایل مخفی شده  bashrc. را نمایان کنید. سپس دو خط زیر را با توجه به مسیر فولدر Geant4 نصب شده در انتهای فایل وارد کنید. برای اینکه اشتباه تایپی و ... رخ ندهد بهتر است که به  آدرس مشخص شده بروید و با زدن ctrl+l آدرس بار محل نمایان می‌شود و حال همان را در انتهای فایل .bashrc وارد کنید.

source    /usr/local/include/geant4.10.02-install/bin/geant4.sh

source   /usr/local/include/geant4.10.02-install/share/Geant4-10.2.3/geant4make/geant4make.sh

برای مشاهده‌ی فایل های C++ می توانید برنامه ویرایش متن  geany  را با دستور  sudo apt-get install geany نصب کنید.

---

اما پیشنهاد می کنم حتماْ ویراستار eclipse را  به عنوان ادیتورتان انتخاب کنید تا بتوانید حرفه ای تر کار کنید.

---

حال نصب برنامه شما با موفقیت انجام شده است.

برای اطمینان از نصب کامل و در ست برنامه، به این لینک بروید و یک مثال را اجرا کنید.