Osdag/C2/Installation-of-Osdag-in-Ubuntu/English - Revision history

Madhurig at 08:04, 25 May 2023

2023-05-25T08:04:51Z

Madhurig at 07:50, 25 May 2023

2023-05-25T07:50:05Z

Show changes

Danish at 10:18, 4 May 2023

2023-05-04T10:18:17Z

Danish at 12:25, 3 May 2023

2023-05-03T12:25:43Z

Anandajitht: Created page with "'''Title of the script''': '''Installation of Osdag in Ubuntu''' '''Author''': Zahran Sajid '''Keywords:''' Osdag, Installation, Ubuntu Linux, Osdag, Terminal, text editor,..."

2023-04-17T19:40:19Z

Created page with "'''Title of the script''': '''Installation of Osdag in Ubuntu''' '''Author''': Zahran Sajid '''Keywords:''' Osdag, Installation, Ubuntu Linux, Osdag, Terminal, text editor,..."

New page

'''Title of the script''': '''Installation of Osdag in Ubuntu'''

'''Author''': Zahran Sajid

'''Keywords:''' Osdag, Installation, Ubuntu Linux, Osdag, Terminal, text editor, video tutorial.

{|border=1
| align=center| Visual Cue
| align=center| Narration
|-
||'''Slide:'''

'''Title Slide
|| Welcome to the spoken tutorial on '''‘Installation''' '''of Osdag in Ubuntu’.'''
|-
|| '''Slide: '''Learning Objectives
|| In this tutorial, we will learn to:
* Download and install '''Osdag''' in '''Ubuntu Linux OS'''
* Open '''Osdag '''through '''Terminal'''
* Verify the installation

|-
|| '''Slide:'''

'''System Requirements'''
|| To record this tutorial, I am using:* '''Ubuntu Linux''' '''20.04'''
* '''Osdag''' version''' v2021.02.a.a12f'''
* '''gedit '''text editor''', '''and
* A working '''internet '''connection

|-
|| '''Slide:'''

'''Pre-requisites

[https://spoken-tutorial.org/ https://spoken-tutorial.org]
|| To follow this tutorial, the user should be familiar with,
* Basic '''Linux '''commands
* A text editor in '''Linux''', and
* Basics of '''structural steel design'''

For prerequisite '''Linux''' and '''gedit Text Editor '''tutorials please visit this website.
|-
||'''Slide:'''
'''Hardware Requirements'''
|| For a successful installation, we will need
* 64-'''bit''' '''Ubuntu Linux''' (18.04 or later version)
* Minimum of 4''' GB''' '''RAM'''
* Minimum of 4 '''GB''' '''hard disk''' space

|-
|| '''Slide: '''Code Files
||
* The files used in this tutorial are available in the'''Code Files '''
* Please download and extract them
* Make a copy and then use them while practising

|-
|| Show '''commands.txt '''using '''gedit'''
|| I have opened the '''commands.txt''' file in the '''gedit text editor''' on my system.

You may use any other '''editor''' of your choice.
|-
|| Only Narration

Press '''Ctrl, Shift, '''and '''V ''' keys to paste in the Terminal.
|| I will use the same file to copy the '''commands''' during the demonstration.

'''Commands''' on the '''terminal''' can be pasted by pressing '''Ctrl, Shift''', and '''V ''' keys together.
|-
||Only Narration
|| Let us first download the '''installer''' file from the '''Osdag''' website.

Open any '''web browser '''of your choice.
|-
|| Open '''Mozilla Firefox'''
|| I have opened the '''Mozilla Firefox''' web browser.
|-
|| Type''' '''‘'''osdag.fossee.in'''’ and press '''Enter'''
|| In the '''address bar''' type the '''URL ‘osdag.fossee.in’''' and press '''Enter'''.
|-
|| Cursor on the homepage of '''Osdag'''.
||We see the homepage of the '''Osdag ''' website.
|-
|| '''Mozilla Firefox:'''

Click on “'''Downloads'''” tab.
|| In the top '''menu bar''', click on the '''Downloads''' tab'''.
|-
|| Point toward the '''Downloads''' page
||We will be redirected to the '''Downloads''' page.

The ''' Osdag installers''' for '''Ubuntu Linux''' and '''Windows OS ''' are listed here.
|-
||Scroll and point towards the release dates.
||The '''installers''' are listed according to their release date.
|-
|| Point towards '''1. Installer [Release: 2021-02-15]'''
||The topmost '''installer ''' is for the latest '''version '''of '''Osdag.'''
|-
||Scroll the page to show the older versions.
|| Older versions of '''Osdag '''are listed below.
|-
|| '''Mozilla Firefox:'''

Click on '''Installer-Linux'''
|| Click on the '''Installer-Linux '''link.
|-
||Only Narration
|| We will be redirected to the '''Osdag User Information Form '''page.
|-
|| '''Mozilla Firefox:'''

Show filled '''Osdag User Information Form'''

|| To download the '''Osdag '''Installer, the required details must be filled in.

I have already filled the '''form.'''

|-
||Only Narration
|| The details will be used for internal '''quality assessment''' purposes only.

So, please do not hesitate to submit the details.
|-
|| Click on '''Submit'''
||Click on '''Submit''' at the end of the '''form '''to start downloading the '''Osdag installer.'''
|-
|| Point toward the '''Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz''' file in the '''Downloads directory'''

||'''Osdag '''installer is now downloaded and saved to the '''Downloads directory '''on my system.

|-
||Only Narration
|| Let us proceed with the installation process.

|-
|| Show '''terminal '''and '''gedit '''text editor opened side-by-side

Press Ctrl + Alt+ T keys to open the Terminal.
|| I have opened the '''terminal '''and '''gedit '''text editor.

I will switch between them as required.

|-
||Only Narration
|| I will now go to the '''Downloads directory''' where I have saved the''' installer '''file.

Users need to choose the '''directory '''where the '''installer '''file is saved.
|-
|| '''Terminal:'''

Type '''cd (space) Downloads''' and press''' Enter'''
|| In the '''terminal''', I will type '''cd (space) Downloads''' and press''' Enter.'''
|-
||Only Narration
|| Here onwards, please remember to press the '''Enter''''''key '''after typing each '''command.'''
|-
|| '''Terminal:'''

Type '''ls '''and press '''Enter'''
|| Type '''ls''' to check whether the '''installer''' file listed in the '''current directory.'''
|-
|| '''Terminal:'''

Point towards '''Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz''' file
||

The list shows the '''installer''' file.
|-
|| '''gedit '''text editor''':'''

Copy '''tar -xvf Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz'''
|| To extract the '''installer''' file, copy the first '''command''' from the '''Code file.'''
|-
|| '''Terminal:'''

Paste in the '''Terminal''' and press '''Enter'''
|| Paste it in the '''terminal'''and press '''Enter.'''
|-
||Only Narration
||Now we have to navigate into the extracted '''Osdag installer folder.'''
|-
||'''gedit '''text editor''':'''

Copy '''cd Osdag_ubuntu_installer_v2021.02.a.a12f'''
||Copy the next '''command''' from the '''Code file'''.

|-
||'''Terminal:'''

Paste in the '''Terminal''' and press '''Enter'''
||Paste it in the '''terminal '''and press '''Enter.'''
|-
|| '''Slide:'''

'''Installation Steps'''

|| Installing '''Osdag '''is a two-step process
* First step is to install "'''Miniconda'''
* Second step is to install "'''Osdag'''

|-
|| '''Slide:'''

What is Miniconda?
|| * "'''Conda'''" is a "'''cross-platform package manager'''
* "'''Miniconda'''" is a minimal installer for conda
* "'''Conda'''" installs, runs and updates "the" "'''packages '''"and their "'''dependencies'''

|-
|| Show '''terminal '''and '''gedit '''text editor opened side-by-side
|| Now, let us proceed with the installation.
|-
|| '''gedit '''text editor''':'''

Copy '''bash 1-install-Miniconda3-latest-Linux-x86_64.sh'''
|| For installing '''Miniconda, '''copy the third command from the '''Code file.'''
|-
|| '''Terminal:'''

Paste in the '''Terminal''' and press '''Enter'''
|| Paste it in the '''terminal '''and press '''Enter.'''
|-
|| '''Terminal:'''

Press '''Enter '''several times

Point to '''More''' on the terminal.
|| Press '''Enter''' several times to scroll through the '''Miniconda Licence '''page.
|-
|| '''Terminal:'''

Type '''yes '''and press '''Enter'''
||

Type '''yes''' to approve the '''licence''' '''terms''' and continue.

|-
|| Cursor at the prompt.

Only Narration.
|| '''Miniconda''' will prompt you for the location where it needs to be installed.

By '''default''', it will be installed in the user’s''' home directory.'''

We can optionally specify another location of our choice.

I will go ahead with the '''default '''location.
|-
|| '''Terminal:'''

Press''' Enter'''
|| Press '''Enter '''to confirm and proceed further.
|-
|| '''Terminal: '''

Type '''yes '''and press '''Enter'''
|| Type '''yes''' and press '''Enter''' to initialise '''Miniconda3 '''by running '''conda init.'''
|-
|| Point to the message.
|| We can see a message notifying the successful installation of '''Miniconda.'''
|-
|| Close and reopen the '''Terminal''' by pressing the '''Ctrl, Alt and T '''keys together
|| I will close the terminal and then reopen it by pressing the '''Ctrl, Alt and T '''keys together.

|-
|| Only narration
|| This step is necessary for the '''miniconda '''installation to take effect.
|-
|| Only narration
|| Now we have to again navigate into the extracted '''Osdag installer folder.'''
|-
|| '''Terminal:'''

Type '''cd (space) Downloads''' and press''' Enter'''
|| In the '''terminal''', I will type '''cd (space) Downloads''' and press''' Enter.'''
|-
||'''gedit '''text editor''':'''

Copy '''cd Osdag_ubuntu_installer_v2021.02.a.a12f'''
||

Copy the second '''command''' from the '''Code file'''.

|-
||'''Terminal:'''

Paste in the '''Terminal''' and press '''Enter'''
||

Paste it in the '''terminal '''and press '''Enter.'''
|-
|| Only narration
|| Now let us proceed with the installation of '''Osdag.'''
|-
|| '''gedit '''text editor''':'''

Copy '''bash 2-install-osdag.sh'''

|| For installing '''Osdag''', copy the fourth '''command''' from the '''Code file'''.

|-
|| '''Terminal:'''

Paste in the '''Terminal''' and press '''Enter'''
|| Paste it in the '''terminal '''and press '''Enter.'''
|-
|| '''Terminal:'''

Point to the success message
|| Once the installation is complete, a success message is displayed.

This means we have successfully installed '''Osdag''' in our system.
|-
|| Only narration

|| By default,''' Osdag''' will be installed in the '''home directory.'''

We can confirm this by checking our specified''' installation directory.'''
|-
|| Only narration

|| Let us go to the '''home directory''' using the '''cd command.'''

|-
|| '''Terminal:'''

Type '''cd $HOME'''
|| Type''' cd $HOME'''
|-
|| Only narration
|| Now we are in the '''home directory.'''
|-
|| '''Terminal:'''

Type''' ls''' and press '''Enter'''
|| Type '''ls '''and press '''Enter.'''

|-
|| '''Terminal:'''

Point towards '''miniconda3''' and '''Osdag''' directories
|| We see '''‘miniconda3’''' and '''‘Osdag’''' directories listed under the '''home directory.'''
|-
|| Only narration
|| We can also change the location of '''Osdag.'''

To do so, simply move the '''Osdag''' directory to the preferred location.
|-
|| Only narration
|| Let us now launch '''Osdag''' through the '''Terminal.'''
|-
|| '''Terminal: '''

Type '''cd Osdag'''
|| To enter the '''Osdag directory''', type''' cd Osdag'''
|-
|| '''gedit '''text editor''':'''

Copy '''python osdagMainPage.py'''
||

To start '''Osdag''', copy the last '''command''' from the '''Code file.'''
|-
|| '''Terminal:'''

Paste and press '''Enter'''
||

Paste the '''command '''in the '''terminal '''and press '''Enter.'''
|-
||Only Narration

|| It may take some time to open '''Osdag '''for the very first time.

|-
|| Point towards the '''Osdag''' '''Interface'''
|| Now we can see the '''Osdag''' interface on the screen.
|-
|| Only narration
|| Let us validate the installation by running a '''sample design example.'''
|-
|| '''Osdag:'''

Click on the '''Connection module'''
|| Click on the '''Connection module '''present at the top left side.
|-
|| Click on '''Fin Plate''' image
|| Click on the '''Fin Plate '''image to select the '''module.'''
|-
|| Click on '''Start'''
|| Click on the '''Start button '''below to launch the '''module.'''
|-
|| Only narration
|| The '''module '''might take some time to launch.
|-
|| '''Fin Plate Connection GUI:'''

Click on '''File''' '''Load input'''
|| Go to the '''File menu''' present at the top left corner, and select '''Load input.'''
|-
|| '''Open Design Window:'''

Browse to the '''Code file directory'''
|| I will browse to the '''Code file directory.'''
|-
|| '''Open Design Window:'''

Select the '''FinPlate_sample_design.osi '''file and click on '''Open'''
|| Select '''FinPlate_sample_design.osi, '''and

Click on the '''Open button.'''
|-
|| Point toward the''' Input Dock fields'''
|| We see the input values are populated for our '''sample design example'''.

|-
|| Only narration
|| We are now ready to perform the '''design'''.
|-
|| '''Fin Plate Connection GUI:'''

Click on the '''Design button'''
|| Click on the '''Design button '''at bottom to start.
|-
|| '''Osdag:'''

Point towards the '''CAD window '''and the '''Log messages window'''
|| Osdag will display the '''CAD model''' and print '''log messages.'''
|-
|| Only narration
|| This means that the '''design '''is complete.

This indicates that the installation of '''Osdag '''is successful.
|-
|| Only narration
|| This brings us to the end of this tutorial.

Let us summarise.
|-
|| '''Slide:'''

'''Summary'''

|| In this tutorial, we have

* Downloaded and installed '''Osdag''' on '''Ubuntu''' '''Linux OS'''
* Opened '''Osdag '''through''' Terminal'''
* Verified the installation

|-
|| '''Slide:'''

'''About Spoken Tutorial Project'''
|| The video at the following link summarises the Spoken Tutorial Project

Please download and watch it
|-
|| '''Slide:'''

'''Spoken Tutorial Workshops'''
|| The Spoken Tutorial Project team conducts workshops and gives certificates.

For more details, please write to us
|-
|| '''Slide:'''

'''Answers for THIS Spoken Tutorial'''
||Please post your timed queries in this forum
|-
|| '''Slide:'''

'''FOSSEE Forum
||For any general or technical questions on Osdag, visit the FOSSEE forum and post your question
|-
|| '''Slide: '''

'''Acknowledgements'''
|| The '''Spoken''''''Tutorial''' project is funded by the '''Ministry of Education''', Government of India
|-
|| '''Slide:'''

'''Thank you'''
|| This is '''Zahran Sajid''', a FOSSEE summer fellow 2022, IIT Bombay signing off

Thanks for joining
|-
|}

@@ Line 56: / Line 56: @@
 || For a successful installation, we will need,
-* '''64-bit  Ubuntu Linux''' (18.04 or later version)
+* '''64-bit  Ubuntu Linux''' 18.04 or later version
 * Minimum of  4 '''GB RAM'''.
 * Minimum of  4 '''GB hard disk''' space.
@@ Line 66: / Line 66: @@
 '''Code Files'''
 ||
-* The files used in this tutorial are available in the '''Code Files ''' link
+* The files used in this tutorial are available in the '''Code Files ''' link.
-* Please download and extract them
+* Please download and extract them.
-* Make a copy and then use them while practising
+* Make a copy and then use them while practising.
@@ Line 84: / Line 84: @@
-'''Commands''' on the '''terminal''' can be pasted by pressing '''Ctrl''', '''Shift''', and '''V ''' keys together.
+'''Commands''' on the '''terminal''' can be pasted by pressing the '''Ctrl''', '''Shift''', and '''V ''' keys together.
 |-
 ||Only Narration
@@ Line 242: / Line 242: @@
 || '''Terminal:'''
-Paste in the '''Terminal''' and press '''Enter'''.
+Paste it in the '''Terminal''' and press '''Enter'''.
 || Paste it in the '''terminal ''' and press '''Enter'''.
 |-
@@ Line 282: / Line 282: @@
 Type '''yes '''and press '''Enter'''
-|| Type '''yes''' and press '''Enter''' to initialise '''Miniconda3 '''by running '''conda''' in it.
+|| Type '''yes''' and press '''Enter''' to initialise '''Miniconda3 ''' by running '''conda''' in it.
 |-
 || Point to the message.
@@ Line 300: / Line 300: @@
 Type '''cd (space) Downloads''' and press''' Enter'''
-|| In the '''terminal''', I will type '''cd (space) Downloads''' and press ''' Enter'''.
+|| In the '''terminal''', I will type '''cd space Downloads''' and press ''' Enter'''.
 |-
 ||'''gedit '''text editor''':
@@ Line 338: / Line 338: @@
 |-
 || Only narration
-|| By default,''' Osdag''' will be installed in the '''home directory.'''
+|| By default,''' Osdag''' will be installed in the '''home directory'''.
-We can confirm this by checking our specified''' installation directory.'''
+We can confirm this by checking our specified''' installation directory'''.
 |-
 || '''cd command'''.
@@ Line 353: / Line 353: @@
 |-
 || Only narration
-|| Now we are in the '''home directory.'''
+|| Now we are in the '''home directory'''.
 |-
 || '''Terminal:'''
-Type''' ls''' and press '''Enter'''
+Type''' ls''' and press '''Enter'''.
-|| Type '''ls '''and press '''Enter.'''
+|| Type '''ls '''and press '''Enter'''.
 |-
@@ Line 364: / Line 364: @@
 Point towards '''miniconda3''' and '''Osdag''' directories.
-|| We see '''‘miniconda3’''' and '''‘Osdag’''' directories listed under the '''home directory.'''
+|| We see '''‘miniconda3’''' and '''‘Osdag’''' directories listed under the '''home directory'''.
 |-
 ||Cursor in the terminal.
@@ Line 378: / Line 378: @@
 Type '''cd Osdag'''.
-|| To enter the '''Osdag directory''', type''' cd Osdag'''.
+|| To enter the '''Osdag directory''', type ''' cd space Osdag'''.
 |-
 || '''gedit '''text editor''':'''
@@ Line 388: / Line 388: @@
 Paste and press '''Enter'''
-|| Paste the '''command '''in the '''terminal '''and press '''Enter'''.
+|| Paste the '''command '''in the '''terminal ''' and press '''Enter'''.
 |-
 ||Only Narration
-|| It may take some time to open '''Osdag '''for the very first time.
+|| It may take some time to open '''Osdag ''' for the very first time.
 |-
@@ Line 403: / Line 403: @@
 Click on the '''Connection module'''
-|| Click on the '''Connection module '''present at the top left side.
+|| Click on the '''Connection module ''' present at the top left side.
 |-
 || Click on '''Fin Plate''' image
-|| Click on the '''Fin Plate '''image to select the '''module'''.
+|| Click on the '''Fin Plate ''' image to select the '''module'''.
 |-
 || Click on '''Start'''
@@ Line 443: / Line 443: @@
 Click on the '''Design button'''
-|| Click on the '''Design button '''at bottom to start.
+|| Click on the '''Design button ''' at bottom to start.
 |-
 || '''Osdag:'''
@@ Line 451: / Line 451: @@
 |-
 || Point to the design.
-|| This means that the '''design '''is complete.
+|| This means that the '''design ''' is complete.
@@ Line 477: / Line 477: @@
 '''About Spoken Tutorial Project'''
-|| The video at the following link summarises the Spoken Tutorial Project
+|| The video at the following link summarises the Spoken Tutorial Project.
-Please download and watch it
+Please download and watch it.
 |-
 || '''Slide:'''
@@ Line 487: / Line 487: @@
-For more details, please write to us
+For more details, please write to us.
 |-
 || '''Slide:'''
@@ Line 507: / Line 507: @@
 '''FOSSEE Forum
-||For any general or technical questions on Osdag, visit the FOSSEE forum and post your question
+||For any general or technical questions on '''Osdag''', visit the '''FOSSEE''' forum and post your question
 |-
 || '''Slide: '''

← Older revision		Revision as of 10:18, 4 May 2023
Line 3:		Line 3:
	'''Author''': Zahran Sajid		'''Author''': Zahran Sajid

−	'''Keywords:''' Osdag, Installation, Ubuntu Linux~~, Osdag~~, Terminal, text editor, video tutorial.	+	'''Keywords:''' Osdag, Installation, Ubuntu Linux, Terminal, Miniconda, sample design, Fin Plate, CAD model, conda, text editor, video tutorial.

@@ Line 26: / Line 26: @@
 '''System Requirements'''
-|| To record this tutorial, I am using:* '''Ubuntu Linux''' '''20.04'''
+|| To record this tutorial, I am using:
 * '''Osdag''' version''' v2021.02.a.a12f'''
 * '''gedit '''text editor''', '''and
@@ Line 48: / Line 49: @@
 '''Hardware Requirements'''
 || For a successful installation, we will need
-* 64-'''bit''' '''Ubuntu Linux''' (18.04 or later version)
+* '''64-bit''' '''Ubuntu Linux''' (18.04 or later version)
-* Minimum of 4''' GB''' '''RAM'''
+* Minimum of ''' 4 GB''' '''RAM'''
-* Minimum of 4 '''GB''' '''hard disk''' space
+* Minimum of ''' 4 GB''' '''hard disk''' space
@@ Line 56: / Line 57: @@
 || '''Slide: '''Code Files
 ||
-* The files used in this tutorial are available in the'''Code Files '''
+* The files used in this tutorial are available in the '''Code Files ''' link
 * Please download and extract them
 * Make a copy and then use them while practising
@@ Line 166: / Line 167: @@
 |-
 ||Only Narration
-|| Here onwards, please remember to press the '''Enter''''''key '''after typing each '''command.'''
+|| Here onwards, please remember to press the '''Enter''' '''key ''' after typing each '''command.'''
 |-
 || '''Terminal:'''
 Type '''ls '''and press '''Enter'''
-|| Type '''ls''' to check whether the '''installer''' file listed in the '''current directory.'''
+|| Type '''ls''' to check whether the '''installer''' file is listed in the '''current directory.'''
 |-
 || '''Terminal:'''
@@ Line 188: / Line 189: @@
 Paste in the '''Terminal''' and press '''Enter'''
-|| Paste it in the '''terminal'''and press '''Enter.'''
+|| Paste it in the '''terminal''' and press '''Enter.'''
 |-
 ||Only Narration
@@ Line 209: / Line 210: @@
 || Installing '''Osdag '''is a two-step process
-* First step is to install "'''Miniconda'''
+* First step is to install '''Miniconda'''
-* Second step is to install "'''Osdag'''
+* Second step is to install '''Osdag'''
@@ Line 217: / Line 218: @@
 What is Miniconda?
-|| * "'''Conda'''" is a "'''cross-platform package manager'''
+||
-* "'''Miniconda'''" is a minimal installer for conda
+* '''Conda''' is a '''cross-platform package manager'''
-* "'''Conda'''" installs, runs and updates "the" "'''packages '''"and their "'''dependencies'''
+* '''Miniconda''' is a minimal installer for conda
@@ Line 539: / Line 541: @@
 '''Acknowledgements'''
-|| The '''Spoken''''''Tutorial''' project is funded by the '''Ministry of Education''', Government of India
+|| The '''Spoken''' '''Tutorial''' project is funded by the '''Ministry of Education''', Government of India
 |-
 || '''Slide:'''