GRASS-Wiki - User contributions [en]

Using Eclipse 4.5 (Mars) on Windows 7

2016-02-20T19:49:02Z

⚠️Jrobparsons: Corrected name of 'Project Explorer' in various places.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform the following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Editing
* Syntax highlighting
* Code completion assistance
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /C C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Project Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Project Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS C/C++ Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Project Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

== Build a GRASS C/C++ Module ==

A GRASS C/C++ module is built and copied to the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the module.

'grass7_trunk' -> 'raster' -> r.univar

Right-click on the module folder to access its context menu.

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

Build results will be displayed in the 'Console' window.

The executable is output to the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32 -> 'bin'

You can right-click on r.univar.exe' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Build a GRASS Python Script ==

A GRASS Python script is not built like a GRASS C/C++ module because it is an interpreted language. The Makefile located in the directory of the script is used to install the script in the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the script.

'grass7_trunk' -> 'scripts' -> m.proj

Right-click on the script folder to access its context menu.

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

The script is installed in the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32' -> 'scripts'

You can right-click on 'm.proj.py' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Debug a GRASS C/C++ Module ==

Switch to C/C++ perspective.

Run 'r.univar' (configured using the 'Run a GRASS C/C++ Module' instructions).

Run -> Run Configuration...
Select 'r.univar' under 'C/C++ Application.
'Run'

Open the C/C++ code to be debugged.

Double-click on:
grass7_trunk -> raster -> r.univar -> r.univar_main.c

Switch to Debug perspective.

On the top task bar:

Run -> Debug

The module will execute and stop at the 1st line in main().

Scroll down to this line:

G_get_window(&region);

After this line, set a breakpoint by double-clicking on the line number. You will see a green button appear next to the line number.

On the debug task bar:

Click on the green arrow ( Resume (F8) ).

The module will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

== Debug a GRASS Python Script ==

Switch to PyDev perspective.

Run 'm.proj.py' (configured using the 'Run a GRASS Python Script' instructions).

Run -> Run Configuration...
Select 'm.proj.py' under 'Python Run.
'Run'

Open Python code to be debugged.

Double-click on:
grass7_trunk -> scripts -> m.proj -> m.proj.py

Switch to Debug perspective.

Scroll down to this line:

cmd = ['cs2cs'] + copyinp + outfmt + in_proj.split() + ['+to'] + out_proj.split()

After this line, set a breakpoint by double-clicking on the line number. You will see a green push-pin appear next to the line number.

On the top task bar:

Run -> Debug

The script will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

== Help ==

[http://help.eclipse.org/mars/index.jsp | Eclipse Mars Online Help]

* Workbench User Guide
* C/C++ Development User Guide

[http://www.pydev.org/manual.html | PyDev Manual]

[http://www.eclipse.org/subversive/documentation/ | Subversive User Guide]

[[Category: Documentation]]
[[Category: Development]]

Using Eclipse 4.5 (Mars) on Windows 7

2015-09-12T20:41:02Z

⚠️Jrobparsons: Added help section

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform the following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Editing
* Syntax highlighting
* Code completion assistance
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /C C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS C/C++ Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

== Build a GRASS C/C++ Module ==

A GRASS C/C++ module is built and copied to the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the module.

'grass7_trunk' -> 'raster' -> r.univar

Right-click on the module folder to access its context menu.

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

Build results will be displayed in the 'Console' window.

The executable is output to the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32 -> 'bin'

You can right-click on r.univar.exe' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Build a GRASS Python Script ==

A GRASS Python script is not built like a GRASS C/C++ module because it is an interpreted language. The Makefile located in the directory of the script is used to install the script in the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the script.

'grass7_trunk' -> 'scripts' -> m.proj

Right-click on the script folder to access its context menu.

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

The script is installed in the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32' -> 'scripts'

You can right-click on 'm.proj.py' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Debug a GRASS C/C++ Module ==

Switch to C/C++ perspective.

Run 'r.univar' (configured using the 'Run a GRASS C/C++ Module' instructions).

Run -> Run Configuration...
Select 'r.univar' under 'C/C++ Application.
'Run'

Open the C/C++ code to be debugged.

Double-click on:
grass7_trunk -> raster -> r.univar -> r.univar_main.c

Switch to Debug perspective.

On the top task bar:

Run -> Debug

The module will execute and stop at the 1st line in main().

Scroll down to this line:

G_get_window(&region);

After this line, set a breakpoint by double-clicking on the line number. You will see a green button appear next to the line number.

On the debug task bar:

Click on the green arrow ( Resume (F8) ).

The module will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

== Debug a GRASS Python Script ==

Switch to PyDev perspective.

Run 'm.proj.py' (configured using the 'Run a GRASS Python Script' instructions).

Run -> Run Configuration...
Select 'm.proj.py' under 'Python Run.
'Run'

Open Python code to be debugged.

Double-click on:
grass7_trunk -> scripts -> m.proj -> m.proj.py

Switch to Debug perspective.

Scroll down to this line:

cmd = ['cs2cs'] + copyinp + outfmt + in_proj.split() + ['+to'] + out_proj.split()

After this line, set a breakpoint by double-clicking on the line number. You will see a green push-pin appear next to the line number.

On the top task bar:

Run -> Debug

The script will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

== Help ==

[http://help.eclipse.org/mars/index.jsp | Eclipse Mars Online Help]

* Workbench User Guide
* C/C++ Development User Guide

[http://www.pydev.org/manual.html | PyDev Manual]

[http://www.eclipse.org/subversive/documentation/ | Subversive User Guide]

[[Category: Documentation]]
[[Category: Development]]

Using Eclipse 4.5 (Mars) on Windows 7

2015-09-12T20:29:02Z

⚠️Jrobparsons: Added build and debug sections.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform the following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Editing
* Syntax highlighting
* Code completion assistance
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /C C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS C/C++ Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

== Build a GRASS C/C++ Module ==

A GRASS C/C++ module is built and copied to the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the module.

'grass7_trunk' -> 'raster' -> r.univar

Right-click on the module folder to access its context menu.

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'clean' in the 'Target name' field.
'OK'

Right-click on 'r.univar'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

Build results will be displayed in the 'Console' window.

The executable is output to the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32 -> 'bin'

You can right-click on r.univar.exe' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Build a GRASS Python Script ==

A GRASS Python script is not built like a GRASS C/C++ module because it is an interpreted language. The Makefile located in the directory of the script is used to install the script in the distribution directory.

Open Project.

Right-click on 'grass7_trunk'.
Select 'Open project'.

Expand the source code tree.

Scroll down to the script.

'grass7_trunk' -> 'scripts' -> m.proj

Right-click on the script folder to access its context menu.

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Create...'.
Enter 'default' in the 'Target name' field.
'OK'

Right-click on 'm.proj'.
Hover over 'Make Targets' and select 'Build...'.
Enter 'default' in the 'Target name' field.
'OK'

The script is installed in the distribution directory:

'grass7_trunk' -> 'dist.i686-pc-mingw32' -> 'scripts'

You can right-click on 'm.proj.py' in the distribution directory and select 'Properties' to get the 'Last modified' date and time.

== Debug a GRASS C/C++ Module ==

Switch to C/C++ perspective.

Run 'r.univar' (configured using the 'Run a GRASS C/C++ Module' instructions).

Run -> Run Configuration...
Select 'r.univar' under 'C/C++ Application.
'Run'

Open the C/C++ code to be debugged.

Double-click on:
grass7_trunk -> raster -> r.univar -> r.univar_main.c

Switch to Debug perspective.

On the top task bar:

Run -> Debug

The module will execute and stop at the 1st line in main().

Scroll down to this line:

G_get_window(&region);

After this line, set a breakpoint by double-clicking on the line number. You will see a green button appear next to the line number.

On the debug task bar:

Click on the green arrow ( Resume (F8) ).

The module will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

== Debug a GRASS Python Script ==

Switch to PyDev perspective.

Run 'm.proj.py' (configured using the 'Run a GRASS Python Script' instructions).

Run -> Run Configuration...
Select 'm.proj.py' under 'Python Run.
'Run'

Open Python code to be debugged.

Double-click on:
grass7_trunk -> scripts -> m.proj -> m.proj.py

Switch to Debug perspective.

Scroll down to this line:

cmd = ['cs2cs'] + copyinp + outfmt + in_proj.split() + ['+to'] + out_proj.split()

After this line, set a breakpoint by double-clicking on the line number. You will see a green push-pin appear next to the line number.

On the top task bar:

Run -> Debug

The script will execute and stop at the breakpoint.

Hover over any variable to bring up a pop-up window to view its value.

The state of variables executed up to this point will be displayed on the 'Variables' view tab.

[[Category: Documentation]]
[[Category: Development]]

Using Eclipse 4.5 (Mars) on Windows 7

2015-09-01T01:32:18Z

⚠️Jrobparsons: /* Introduction */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform the following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Editing
* Syntax highlighting
* Code completion assistance
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /C C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

[[Category: Documentation]]
[[Category: Development]]

Using Eclipse 4.5 (Mars) on Windows 7

2015-09-01T01:27:17Z

⚠️Jrobparsons: /* Setup Eclipse GRASS Environment */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /C C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

[[Category: Documentation]]
[[Category: Development]]

Eclipse.bat

2015-09-01T01:25:50Z

⚠️Jrobparsons: Updated variable names to be common with GRASS startup.

<source lang=text>
@echo off
SETLOCAL

::
:: Reference:
:: http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly
::

echo.
echo. Eclipse 4.5 (Mars) 32-bit for GRASS Development

:: top-level directory of the OSGeo4W installation

set OSGEO4W_ROOT=C:\OSGeo4W

:: top-level directory of the GRASS installation

set GISBASE=%OSGEO4W_ROOT%\src\grass7_trunk\dist.i686-pc-mingw32

:: User Home

if not defined HOME set HOME=%USERPROFILE%

:: GRASS Database

set GISDBASE=%HOME%\grassdata

:: GRASS Location and Mapset for this session

set LOCATION_NAME=nc_spm_08_grass7
set MAPSET=user1
::set MAPSET=PERMANENT
::set GUI=wxpython
set GUI=text

:: Set Debug Message Level
:: 0 - silence
:: 1 - message is printed once or few times per module
:: 3 - each row (raster) or line (vector)
:: 5 - each cell (raster) or point (vector)

set MESSAGE_LEVEL=0

set MINGW_HOME=%OSGEO4W_ROOT%
set MSYS_HOME=%OSGEO4W_ROOT%\apps\msys

set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set GDAL_DRIVER_PATH=%OSGEO4W_ROOT%\bin\gdalplugins
set GEOTIFF_CSV=%OSGEO4W_ROOT%\share\epsg_csv

:: Python Interpreter and Libraries

set PYTHONHOME=%OSGEO4W_ROOT%\apps\Python27

set PYTHONPATH=%OSGEO4W_ROOT%\apps\grass\grass-7.1.svn\etc\python
set PYTHONPATH=%PYTHONPATH%;%OSGEO4W_ROOT%\apps\grass\grass-7.1.svn\gui\wxpython

:: GRASS environment

set GRASS_PYTHON=%OSGEO4W_ROOT%\bin\python.exe
set GRASS_PROJSHARE=%OSGEO4W_ROOT%\share\proj

:: GISRC needs to contain the absolute path to a file containing
:: settings for GISDBASE, LOCATION_NAME and MAPSET.

set GISRC=%HOME%\gisrc

:: Create GISRC file
:: Examples:
:: ./demolocation/grassrc.tmpl
:: ./dist.i686-pc-mingw32/demolocation/.grassrc71

echo GISDBASE: %GISDBASE%> %GISRC%
echo LOCATION_NAME: %LOCATION_NAME%>> %GISRC%
echo MAPSET: %MAPSET%>> %GISRC%
echo GUI: %GUI%>> %GISRC%
echo DEBUG: ^%MESSAGE_LEVEL%>> %GISRC%
echo.

::type %GISRC%

set PATH=%PATH%;%OSGEO4W_ROOT%\bin
set PATH=%PATH%;%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%OSGEO4W_ROOT%\apps\msys\bin
set PATH=%PATH%;%OSGEO4W_ROOT%\apps\Python27
set PATH=%PATH%;%OSGEO4W_ROOT%\apps\Python27\Scripts
set PATH=%PATH%;%GISBASE%\bin
set PATH=%PATH%;%GISBASE%\lib
set PATH=%PATH%;%GISBASE%\scripts

echo.
echo. HOME : %HOME%
echo. GISBASE : %GISBASE%
echo. GISRC : %GISRC%
echo. GISDBASE : %GISDBASE%
echo. LOCATION_NAME : %LOCATION_NAME%
echo. MAPSET : %MAPSET%
echo. MESSAGE_LEVEL : %MESSAGE_LEVEL%
echo. PYTHONPATH : %PYTHONPATH%
echo. PYTHONHOME : %PYTHONHOME%
::echo. PATH : %PATH%
echo.

C:\eclipse-4.5-mars-32bit\eclipse.exe

ENDLOCAL
</source>

[[Category: Documentation]]
[[Category: Development]]

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T18:27:53Z

⚠️Jrobparsons: Added 'Train Eclipse' section.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Train Eclipse ==

Eclipse needs to discover all the C/C++, Python and Make symbols used to build GRASS. This requires that a complete GRASS system build be performed from the Eclipse workbench. This is accomplished using the following procedure:

Start Eclipse.
Open the 'grass7_trunk' project.
Click on the project to highlight it.

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'clean' option that has an empty field under the 'Location' column.
'Build'

Select 'Project' on the main task bar.
Hover over 'Make Targets' and select 'Build...' from the pop-up list.
Select the 'default' option that has an empty field under the 'Location' column.
'Build'

This will take some time to complete.

Click on the icon (stacked rectangles) in the lower right-hand corner of the workbench to view progress.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:52:59Z

⚠️Jrobparsons: /* Run a GRASS Script */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:51:57Z

⚠️Jrobparsons: /* Create C/C++ Project */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project located in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:51:36Z

⚠️Jrobparsons: /* Create C/C++ Project */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project, .cproject, and .settings files in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project located in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:50:16Z

⚠️Jrobparsons: /* Run a GRASS Script */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project and .cproject files located in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating .pydevproject and updating .project located in the top-level directory of the GRASS source code installion.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:46:51Z

⚠️Jrobparsons: /* Create C/C++ Project */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

'''Note''': This results in creating the Eclipse .project and .cproject files located in the top-level directory of the GRASS source code installation.

C:\OSGeo4G\src\grass7_trunk

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating the .pydevproject file and updating the .project file located in the top-level directory where the GRASS source code was installed.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:43:48Z

⚠️Jrobparsons: /* Run a GRASS Script */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

'''Note''': The first time a run configuration for a Python script is performed, Eclipse discovers that it must add the Python (PyDev) 'nature' to the project. This results in creating the .pydevproject file and updating the .project file located in the top-level directory where the GRASS source code was installed.

C:\OSGeo4G\src\grass7_trunk

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:03:25Z

⚠️Jrobparsons: /* Run a GRASS Python Script */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T17:02:47Z

⚠️Jrobparsons: /* Run a GRASS C Application */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Module.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Module.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:59:44Z

⚠️Jrobparsons: /* Setup Eclipse GRASS Environment */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Modify the contents for your particular Windows and GRASS development environment.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:53:51Z

⚠️Jrobparsons: /* Setup Eclipse GRASS Environment */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

We will start Eclipse from a Windows batch file. This will provide the opportunity to set environment variable required by both the GRASS runtime modules and the Eclipse workbench.

1. Exit Eclipse.

File -> Exit

2. Install eclipse.bat.

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory where Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

Copy the contents from [[eclipse.bat]] to the eclipse.bat file you created.

Save and exit eclipse.bat.

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

3. Update Eclipse Icon Properties.

Update the '''Properties''' of the Eclipse startup icon that is on your Windows desktop.

Right-click on the desktop icon and change the '''Target''' field to something like this:

C:\Windows\System32\cmd.exe /D /K C:\eclipse-4.5-mars-32bit\eclipse.bat

Select 'OK' to save the change.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:35:53Z

⚠️Jrobparsons: /* Install Doxygen and Make Documentation */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen] website. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz] website. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX] website.

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:35:02Z

⚠️Jrobparsons: /* Install TortoiseSVN */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN] website.

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:34:29Z

⚠️Jrobparsons: /* Checkout GRASS Source Code and Make Debug Build */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download] website.

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:34:06Z

⚠️Jrobparsons: /* Install OSGeo4W Runtime and Development Framework */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W] website.

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T16:32:55Z

⚠️Jrobparsons: Add information about what Eclipse will use after a debug build.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

In addition to building and installing GRASS, which can be run using the created Windows desktop icon, the Eclipse workbench will be able to use these artifacts that are created during a GRASS build:

* Top-level Makefile
* Module-level Makefiles
* Symbol tables added to runtime binaries

Makefiles allow the Eclipse workbench to re-build the entire GRASS system or to re-build individual GRASS modules after source code editing.

Symbol tables allow the Eclipse debugger (GDB) to set break-points in source code, single step through source code, and view the values of source code variables and structures.

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Eclipse.bat

2015-08-30T15:49:25Z

⚠️Jrobparsons:

<source lang=text>
@echo off
SETLOCAL

::
:: Reference:
:: http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly
::

echo.
echo. Eclipse 4.5 (Mars) 32-bit for GRASS Development

:: User Home

set "HOME=%HOMEDRIVE%\%HOMEPATH%"

:: GRASS Database

set "GISDBASE=%HOME%\grassdata"
set "LOCATION_NAME=nc_spm_08_grass7"
set "MAPSET=user1"
::set "MAPSET=PERMANENT"
::set "GUI=wxpython"
set "GUI=text"

:: Set Debug Message Level
:: 0 - silence
:: 1 - message is printed once or few times per module
:: 3 - each row (raster) or line (vector)
:: 5 - each cell (raster) or point (vector)

set "MESSAGE_LEVEL=^1"

set "MINGW_HOME=C:\OSGeo4W"
set "MSYS_HOME=C:\OSGeo4W\apps\msys"

:: Python Interpreter and Libraries

set "PYTHONHOME=C:\OSGeo4W\apps\Python27"
set "PYTHONPATH=C:\OSGeo4W\apps\grass\grass-7.1.svn\etc\python;C:\OSGeo4W\apps\grass\grass-7.1.svn\gui\wxpython"

:: Build tools and utilities

set "TOOLS=C:\OSGeo4W\bin;C:\OSGeo4W\apps\msys\bin;C:\OSGeo4W\apps\Python27"

:: GISBASE needs to be set to the top-level directory
:: of the GRASS installation.

set "GISBASE=C:\OSGeo4W\src\grass7_trunk\dist.i686-pc-mingw32"

:: GISRC needs to contain the absolute path to a file containing
:: settings for GISDBASE, LOCATION_NAME and MAPSET.

set "GISRC=%HOME%\gisrc"

:: Create GISRC file
:: Examples:
:: ./demolocation/grassrc.tmpl
:: ./dist.i686-pc-mingw32/demolocation/.grassrc71

echo GISDBASE: %GISDBASE%>> %GISRC%
echo LOCATION_NAME: %LOCATION_NAME%> %GISRC%
echo MAPSET: %MAPSET%>> %GISRC%
echo GUI: %GUI%>> %GISRC%
echo DEBUG: %MESSAGE_LEVEL%>> %GISRC%

::type %GISRC%

set "PROJ=C:\OSGeo4W\share\proj"
set "GLIB=%GISBASE%\lib"
set "GBIN=%GISBASE%\bin"
set "GSCRIPTS=%GISBASE%\scripts"

:: PATH needs to include %GISBASE%\bin and %GISBASE%\scripts and %GISBASE%\libs.
set PATH=%PATH%;%TOOLS%;%GBIN%;%GLIB%;%GSCRIPTS%;%PROJ%

echo.
echo. HOME : %HOME%
echo. GISBASE : %GISBASE%
echo. GISRC : %GISRC%
echo. GISDBASE : %GISDBASE%
echo. LOCATION_NAME : %LOCATION_NAME%
echo. MAPSET : %MAPSET%
echo. PYTHONPATH : %PYTHONPATH%
echo. PYTHONHOME : %PYTHONHOME%

C:\eclipse-4.5-mars-32bit\eclipse.exe

ENDLOCAL
</source>

Eclipse.bat

2015-08-30T15:44:29Z

⚠️Jrobparsons:

<source lang=winbatch>
@echo off
SETLOCAL

::
:: Reference:
:: http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly
::

echo.
echo. Eclipse 4.5 (Mars) 32-bit for GRASS Development

:: User Home

set HOME=%HOMEDRIVE%\%HOMEPATH%

:: GRASS Database

set GISDBASE=%HOME%\grassdata
set LOCATION_NAME=nc_spm_08_grass7
set MAPSET=user1
::set MAPSET=PERMANENT
::set GUI=wxpython
set GUI=text

:: Set Debug Message Level
:: 0 - silence
:: 1 - message is printed once or few times per module
:: 3 - each row (raster) or line (vector)
:: 5 - each cell (raster) or point (vector)

set MESSAGE_LEVEL=^1

set MINGW_HOME=C:\OSGeo4W
set MSYS_HOME=C:\OSGeo4W\apps\msys

:: Python Interpreter and Libraries

set PYTHONHOME=C:\OSGeo4W\apps\Python27
set PYTHONPATH=C:\OSGeo4W\apps\grass\grass-7.1.svn\etc\python;C:\OSGeo4W\apps\grass\grass-7.1.svn\gui\wxpython

:: Build tools and utilities

set TOOLS=C:\OSGeo4W\bin;C:\OSGeo4W\apps\msys\bin;C:\OSGeo4W\apps\Python27

:: GISBASE needs to be set to the top-level directory
:: of the GRASS installation.

set GISBASE=C:\OSGeo4W\src\grass7_trunk\dist.i686-pc-mingw32

:: GISRC needs to contain the absolute path to a file containing
:: settings for GISDBASE, LOCATION_NAME and MAPSET.

set GISRC=%HOME%\gisrc

:: Create GISRC file
:: Examples:
:: ./demolocation/grassrc.tmpl
:: ./dist.i686-pc-mingw32/demolocation/.grassrc71

echo GISDBASE: %GISDBASE%>> %GISRC%
echo LOCATION_NAME: %LOCATION_NAME%> %GISRC%
echo MAPSET: %MAPSET%>> %GISRC%
echo GUI: %GUI%>> %GISRC%
echo DEBUG: %MESSAGE_LEVEL%>> %GISRC%

::type %GISRC%

set PROJ=C:\OSGeo4W\share\proj
set GLIB=%GISBASE%\lib
set GBIN=%GISBASE%\bin
set GSCRIPTS=%GISBASE%\scripts

:: PATH needs to include %GISBASE%\bin and %GISBASE%\scripts and %GISBASE%\libs.

set PATH=%PATH%;%TOOLS%;%GBIN%;%GLIB%;%GSCRIPTS%;%PROJ%

echo.
echo. HOME : %HOME%
echo. GISBASE : %GISBASE%
echo. GISRC : %GISRC%
echo. GISDBASE : %GISDBASE%
echo. LOCATION_NAME : %LOCATION_NAME%
echo. MAPSET : %MAPSET%
echo. PYTHONPATH : %PYTHONPATH%
echo. PYTHONHOME : %PYTHONHOME%

C:\eclipse-4.5-mars-32bit\eclipse.exe

ENDLOCAL
</source>

Eclipse.bat

2015-08-30T15:32:10Z

⚠️Jrobparsons: Created page with " @echo off SETLOCAL :: :: Reference: :: <nowiki>http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly</nowiki> :: echo. echo. Eclipse 4..."

@echo off
SETLOCAL

::
:: Reference:
:: <nowiki>http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly</nowiki>
::

echo.
echo. Eclipse 4.5 (Mars) 32-bit for GRASS Development

:: User Home

set "HOME=%HOMEDRIVE%\%HOMEPATH%"

:: GRASS Database

set "GISDBASE=%HOME%\grassdata"
set "LOCATION_NAME=nc_spm_08_grass7"
set "MAPSET=user1"
::set "MAPSET=PERMANENT"
::set "GUI=wxpython"
set "GUI=text"

:: Set Debug Message Level
:: 0 - silence
:: 1 - message is printed once or few times per module
:: 3 - each row (raster) or line (vector)
:: 5 - each cell (raster) or point (vector)

set "MESSAGE_LEVEL=^1"

set "MINGW_HOME=C:\OSGeo4W"
set "MSYS_HOME=C:\OSGeo4W\apps\msys"

:: Python Interpreter and Libraries

set "PYTHONHOME=C:\OSGeo4W\apps\Python27"
set "PYTHONPATH=C:\OSGeo4W\apps\grass\grass-7.1.svn\etc\python;C:\OSGeo4W\apps\grass\grass-7.1.svn\gui\wxpython"

:: Build tools and utilities

set "TOOLS=C:\OSGeo4W\bin;C:\OSGeo4W\apps\msys\bin;C:\OSGeo4W\apps\Python27"

:: GISBASE needs to be set to the top-level directory
:: of the GRASS installation.

set "GISBASE=C:\OSGeo4W\src\grass7_trunk\dist.i686-pc-mingw32"

:: GISRC needs to contain the absolute path to a file containing
:: settings for GISDBASE, LOCATION_NAME and MAPSET.

set "GISRC=%HOME%\gisrc"

:: Create GISRC file
:: Examples:
:: ./demolocation/grassrc.tmpl
:: ./dist.i686-pc-mingw32/demolocation/.grassrc71

echo GISDBASE: %GISDBASE%>> %GISRC%
echo LOCATION_NAME: %LOCATION_NAME%> %GISRC%
echo MAPSET: %MAPSET%>> %GISRC%
echo GUI: %GUI%>> %GISRC%
echo DEBUG: %MESSAGE_LEVEL%>> %GISRC%

::type %GISRC%

set "PROJ=C:\OSGeo4W\share\proj"
set "GLIB=%GISBASE%\lib"
set "GBIN=%GISBASE%\bin"
set "GSCRIPTS=%GISBASE%\scripts"

:: PATH needs to include %GISBASE%\bin and %GISBASE%\scripts and %GISBASE%\libs.
set PATH=%PATH%;%TOOLS%;%GBIN%;%GLIB%;%GSCRIPTS%;%PROJ%

echo.
echo. HOME : %HOME%
echo. GISBASE : %GISBASE%
echo. GISRC : %GISRC%
echo. GISDBASE : %GISDBASE%
echo. LOCATION_NAME : %LOCATION_NAME%
echo. MAPSET : %MAPSET%
echo. PYTHONPATH : %PYTHONPATH%
echo. PYTHONHOME : %PYTHONHOME%

C:\eclipse-4.5-mars-32bit\eclipse.exe

ENDLOCAL

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-30T15:28:35Z

⚠️Jrobparsons: Added content.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

Using a text editor, create a Windows batch file named '''eclipse.bat''' in the top-level directory with Eclipse is installed.

The top-level Eclipse directory used in this tutorial is:

C:\eclipse-4.5-mars-32bit

The contents of '''eclipse.bat''' are list here: [[eclipse.bat]]

Reference: [http://grasswiki.osgeo.org/wiki/Working_with_GRASS_without_starting_it_explicitly Working with GRASS without starting it explicitly]

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T19:56:36Z

⚠️Jrobparsons: /* Install Eclipse Mars */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download] website.

Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download] website.

This tutorial installed Eclipse in this directory:

C:\eclipse-4.5-mars-32bit

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T19:36:08Z

⚠️Jrobparsons: /* Setup Eclipse GRASS Environment */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

Exit Eclipse.

File -> Exit

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T19:30:51Z

⚠️Jrobparsons: Added content.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

In your Windows Home directory, create a directory named 'grassdata'.

Example:

C:\Users\Ruth\grassdata

Download one or more GRASS 7 datasets from the [https://grass.osgeo.org/download/sample-data/ GRASS GIS sample data download] website to the 'grassdata' directory and decompress.

This tutorial uses the 'complete NC location' dataset.

After the 'complete NC location' has been decompressed in the 'grassdata' directory, you should see this sub-directory:

nc_spm_08_grass7

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T18:02:52Z

⚠️Jrobparsons: /* Setup Environment */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

TODO

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Eclipse GRASS Environment ==

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T18:00:21Z

⚠️Jrobparsons: /* Install Data */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install GRASS Database ==

TODO

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Environment ==

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T17:58:54Z

⚠️Jrobparsons: Added 'Install Data' and 'Setup Environment' sections.

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Data ==

TODO

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Setup Environment ==

TODO

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T02:04:53Z

⚠️Jrobparsons: /* Configure Eclipse Settings */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

Enable C/C++ Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

Enable Python Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

Enable Debug Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

Enable SVN Perspective

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

Insert Spaces for Tabs

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

Uncheck Build Automatically

'Project' -> 'Build Automatically' to uncheck this option.

Change Color of Python Comments

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T02:03:15Z

⚠️Jrobparsons: /* Run a GRASS C Application */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'C/C++' Perspective.

Click the 'C/C++' button on the 'Perspective' tool bar.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T02:02:32Z

⚠️Jrobparsons:

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Click the 'PyDev' button on the 'Perspective' tool bar.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T02:00:24Z

⚠️Jrobparsons: /* Run a GRASS Python Script */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Switch to 'PyDev' Perspective.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:55:56Z

⚠️Jrobparsons: /* Run a GRASS C Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Application ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:55:31Z

⚠️Jrobparsons: /* Run a GRASS Python Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Script ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:54:59Z

⚠️Jrobparsons: /* Run a GRASS Python Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured script under 'Python Run'.
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:53:53Z

⚠️Jrobparsons: /* Run a GRASS C Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

Change the run focus.

'Run'
Click on 'Run configurations...'.
Select a configured application under 'C/C++ Application'.
'Run'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:42:40Z

⚠️Jrobparsons: /* Run a GRASS Python Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Script.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj.py' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Scroll down and enter the 'scripts' -> 'm.proj' folder and select 'm.proj.py'.
'OK'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Script.

'Run' -> 'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Local C/C++ Application' from the pop-up list.
Scroll down and select 'r.univar.exe'.
'OK'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:27:52Z

⚠️Jrobparsons: /* Run a GRASS C Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Expand 'grass7_trunk'.

Scroll down and expand the 'scripts' folder.
Scroll down and expand the 'm.proj' folder.
Right-click on 'm.proj.py'.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Navigate to the 'scripts' -> 'm.proj' folder.
Select 'm.proj.py'.
'OK'

Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'
Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Local C/C++ Application' from the pop-up list.
Scroll down and select 'r.univar.exe'.
'OK'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:26:52Z

⚠️Jrobparsons: /* Run a GRASS C Module */

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Expand 'grass7_trunk'.

Scroll down and expand the 'scripts' folder.
Scroll down and expand the 'm.proj' folder.
Right-click on 'm.proj.py'.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Navigate to the 'scripts' -> 'm.proj' folder.
Select 'm.proj.py'.
'OK'

Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'

Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'

'Run'

Output from the run will be displayed in the 'Console' window.

Run Application.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Local C/C++ Application' from the pop-up list.
Scroll down and select 'r.univar.exe'.
'OK'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-29T01:24:10Z

⚠️Jrobparsons: Added 'Run a GRASS C Module'

== Introduction ==

After completing these installation instructions, you will have an IDE for GRASS that will allow you to perform that following development tasks:

Workbench
* Switch between C/C++, Python, Debug and SVN perspectives
Browsing
* Navigate the GRASS source code trunk
* Edit source code
* Select a symbol and go to to its declaration
Building
* Build the entire GRASS system
* Build an individual GRASS module
Running
* Run GRASS modules and Python scripts
Debugging
* Set breakpoints
* Single step through source code
* View variables and memory values
Versioning
* Commit source code to the SVN repository
* Update source code from the SVN repository

== Install TortoiseSVN ==

Download and install from the [http://tortoisesvn.net/ TortoiseSVN Website].

During installation, include the "entire command line tools" so that "svn up" can be run from a Windows Command Prompt or MSYS shell.

The following path should have been added to PATH:

C:\Program Files\TortoiseSVN\bin

From Command Prompt, enter the following command:

>where svn

To run "svn up" from a Command Prompt, enter the following commands:

>cd C:\OSGeo4W\src\grass7_trunk
>svn up

To run "svn up" from a MSYS shell, enter the following commands:

$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ cd /c/OSGeo4W/src/grass7_trunk
$ svn up

== Install OSGeo4W Runtime and Development Framework ==

Download and install the 32bit version from the [http://trac.osgeo.org/osgeo4w/ OSGeo4W Website].

It will be installed in this directory:

C:\OSGeo4W

== Checkout GRASS Source Code and Make Debug Build ==

Checkout the GRASS '''development branch''' using the SVN command from the [https://trac.osgeo.org/grass/wiki/DownloadSource GRASS Download Website].

Open a MSYS shell.

$ cd /c/OSGeo4W/src
$ export PATH=$PATH:/c/"Program Files"/TortoiseSVN/bin
$ which svn
$ svn checkout <nowiki>https://svn.osgeo.org/grass/grass/trunk</nowiki> grass7_trunk

Run a 'debug' build.

$ cd /c/OSGeo4W/src/grass7_trunk
$ export CFLAGS='-g -Wall'
$ ./mswindows/osgeo4w/package.sh

This will take some time to complete.

Build activity is logged to this file:
C:\OSGeo4W\src\grass7_trunk\mswindows\osgeo4w\package.log

== Install Doxygen and Make Documentation ==

Install latest Doxygen binary distribution for Windows. 
Download and install from the [http://www.stack.nl/~dimitri/doxygen/download.html | Doxygen Website]. 

Install latest Graphviz binary distribution for windows. 
Download and install from the [http://graphviz.org/Download_windows.php | Graphviz Website]. 

Install latest basic TeX/LaTeX system for Windows. 
Download and install from the [http://miktex.org/download | MikTeX Website].

After the TeX/LaTeX system is installed, and during the first time "make pdfdocs" is run, expect to be prompted for additional packages that must be installed to complete the TeX/LaTex system.

Open a MSYS shell.

$ export PATH=$PATH:/c/"Program Files"/doxygen/bin
$ export PATH=$PATH:/c/graphviz-2.38/release/bin
$ export PATH=$PATH:/c/"Program Files (x86)"/"MiKTeX 2.9"/miktex/bin
$ echo $PATH
$ cd /c/OSGeo4W/src/grass7_trunk/
$ make htmldocs
$ make pdfdocs

Open the HTML formatted documentation using a web browser:
file:///C:/OSGeo4W/src/grass7_trunk/html/index.html

== Install Eclipse Mars ==

Download and install the 32bit version of Java SE Runtime Environment (JRE) from the [http://www.oracle.com/technetwork/indexes/downloads/index.html#java Java Download Website] 
Download and install the 32bit version of Eclipse IDE for C/C++ Developers from the [http://www.eclipse.org/downloads/ Eclipse Mars Download Website]

== Install PyDev Plug-In ==

Start Eclipse.

Help -> Install New Software...
Select "Add..".
Enter "PyDev" in the "Name: field.
Enter "<nowiki>http://pydev.org/updates/</nowiki>" in the Location" field.
"OK"

Check the "PyDev" option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

== Install SVN Plug-In ==

Start Eclipse.

Install SVN plug-in.

Help -> Install New Software...
Set "Work with:" to "Mars - <nowiki>http://download.eclipse.org/releases/mars</nowiki>".
Expand "Collaboration".
Scroll down and put a check mark in the "Subversive SVN Team Provider option.
"Next"
"Next"
Accept the license agreement.
"Finish"

Restart Eclipse.

When "Subversive Connector Discovery" prompts you for a selection, check "SVN Kit 1.8.10".
"Finish"
"Next"
"Next"
Accept the license agreement.
"Finish"
"OK" to the "security Warning".

Restart Eclipse.

Make SVN visible.

Window → Perspective → Customize Perspective...
Select the "Action Set Availability" tab.
Check the "SVN" option under "Available action sets".
"OK"

Window → Perspective → Customize Perspective...
Select the "Shortcuts" tab.
Check the "SVN" option under "Shortcut Categories".
Select the "Menu Visibility" tab.
Check the "SVN" option under "Menu Structure".
Select the "Tool Bar Visibility" tab.
Check the "SVN" option under "Tool Bar Structure".
"OK"

You should now see "SVN" on the main tool bar and the SVN tool bar available under the main toolbar.

== Configure Eclipse Settings ==

=== Enable C/C++ Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'C/C++'
'OK'

=== Enable Python Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'PyDev'
'OK'

=== Enable Debug Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'Debug'
'OK'

=== Enable SVN Perspective ===

Window -> Perspective -> Open Perspective
Select 'Other...'
Select 'SVN Repository Exploring'
'OK'

=== Insert Spaces for Tabs ===

Window -> Preferences -> General -> Editors -> Text Editors
Set 'Displayed tab width' to 4.
Check 'Insert spaces for tabs'.
'Apply'
'OK'

Window -> Preferences -> C/C++ -> Code Style -> Formatter
Select the 'New' button to create a new profile.
Enter 'GRASS' in the 'Profile name' field.
Select 'OK'.
Select the 'Indentation' tab.
Under 'General settings', set Tab policy to 'Spaces only'.
'OK'

=== Uncheck Build Automatically ===

'Project' -> 'Build Automatically' to uncheck this option.

=== Change Color of Python Comments ===

Window -> Preferences
Expand 'PyDev'.
Select 'Editor'.
In the 'Appearance color options' window:
Scroll down to 'Comments' and select.
Click on the 'Color' button to bring up options.
Select the green color that is located in the 3rd column from the left and 4th row from the top.
'OK'
'Apply'
'OK'

== Create C/C++ Project ==

Create a C++, Makefile, Empty project

"File" -> "New" -> "Project..."
Expand "C/C++" option.
Select "C++ Project"
"Next"

Uncheck 'Use default location'.
Browse to 'C:\OSGeo4W\src\grass7_trunk'.
'OK'
Enter 'grass7_trunk' in the "Project name" field.
Expand 'Makefile project' under 'Project type'.
Select 'Empty Project' under 'Project type'.
Select 'MinGW GCC' under 'Toolchains'.
"Next"

Click on 'Advanced settings...'
Click on 'C/C++ Build'.
Click on the 'Behavior' tab.
Leave 'Build (Incremental Build)' Checked.
Enter 'default' in the text box next to 'Build (Incremental Build)' replacing any text that is already there (e.g., 'all').
'Apply'
'OK'
'Finish'

The 'grass7_trunk' project will appear in the 'Project Explorer' view.

The 'C/C++ Indexer' operation will take some time. Its progress can be monitored in the lower right-hand corner of the screen. Click on the rectangles in the corner to display progress details.

== Create Top-Level Make Targets ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Select "Make Targets"
Select "Create..."
Enter 'default' in the 'Target name' field.
'OK'

Do the same for each of the following targets:

install
clean
distclean
libs
libsclean
cleandistdirs
cleanscriptstrings
manifests

== Run a GRASS Python Module ==

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Expand 'grass7_trunk'.

Scroll down and expand the 'scripts' folder.
Scroll down and expand the 'm.proj' folder.
Right-click on 'm.proj.py'.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'Python Run' and select 'New'.
Enter 'm.proj' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'Main Module' 'Browse...' button.
Navigate to the 'scripts' -> 'm.proj' folder.
Select 'm.proj.py'.
'OK'

Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
coordinates=-111d30,45d15.551666667N proj_out="+proj=utm +zone=10 +datum=NAD27" proj_in="+proj=latlong +datum=NAD83" --v
'Apply'
'Run'

Output from the run will be displayed in the 'Console' window.

== Run a GRASS C Module ==

Open Project.

Right-click on 'grass7_trunk' in the 'Windows Explorer' view.
Click on 'Open Project'.
The Indexer and SVN cache updates will take a moment to complete.

Configure Run.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Run configurations...' from the pop-up list.
Right-click on 'C/C++ Application' and select 'New'.
Enter 'r.univar' in the 'Name' field.
Click the 'Project' 'Browse...' button.
Select 'grass7_trunk'.
'OK'
Click the 'C/C++ Applications' 'Search Project...' button.
Scroll down and select 'r.univar.exe'.
'OK'
'Apply'

Select the 'Arguments' tab.
Enter the following string in the 'Program arguments' window:
map=aspect@PERMANENT
'Apply'

'Run'

Output from the run will be displayed in the 'Console' window.

Run again.

Click on 'Run' on the main task bar.
Hover over 'Run As' and select 'Local C/C++ Application' from the pop-up list.
Scroll down and select 'r.univar.exe'.
'OK'

Output from the run will be displayed in the 'Console' window.

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T03:34:56Z

⚠️Jrobparsons: /* Run a GRASS Python Module */

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T03:28:36Z

⚠️Jrobparsons: /* Run a GRASS Python Module */

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T02:56:05Z

⚠️Jrobparsons:

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T02:47:26Z

⚠️Jrobparsons: /* Run a Python Module */

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T02:47:03Z

⚠️Jrobparsons: /* Add Python 'nature' to the Project */

Using Eclipse 4.5 (Mars) on Windows 7

2015-08-28T02:13:16Z

⚠️Jrobparsons: /* Create C/C++ Project */