Changes between Initial Version and Version 1 of GSoC/2023

Timestamp:

Jan 23, 2023, 8:36:07 PM (18 months ago)

Author:

annakrat

Comment:

--

GSoC/2023

@@ +1 @@
+
+{{{
+#!html
+<!-- direct usage of HTML enables to use the big @ characters at the same line as images -->
+<!-- derived from the HTML taken from GRASS User Mediawiki -->
+<!-- needs to be changed every year (GSoC link and maybe picture) -->
+<!-- also check and update links at the bottom -->
+<p>
+<a href="https://grass.osgeo.org" rel="nofollow">
+<img alt="Grasslogo vector small.png" src="/grass/raw-attachment/wiki/GSoC/2014/Grasslogo_vector_small.png" width="110" height="123" />
+</a>
+ <font size="+3"> @ </font>
+<a href="https://summerofcode.withgoogle.com/" rel="nofollow">
+<img alt="500px-GSoC2016Logo.jpg​" src="/grass/raw-attachment/wiki/GSoC/2016/500px-GSoC2016Logo.jpg"/>
+</a>
+<font size="+3"> @ </font>
+<a href="https://wiki.osgeo.org/wiki/Google_Summer_of_Code_2023" rel="nofollow">
+<img alt="OSGeo logo" src="/grass/raw-attachment/wiki/GSoC/2018/osgeo_logo.png" width="300" height="97" /></a>
+</p> 
+}}}
+
+
+= GRASS Google Summer of Code 2023 =
+
+[[TOC]]
+
+
+== About ==
+
+ * [https://wiki.osgeo.org/wiki/Google_Summer_of_Code_2023 The OSGeo GSoC 2023 main page]
+ * [https://summerofcode.withgoogle.com/ Official GSoC page at Google]
+
+== Ideas ==
+
+''Post your ideas here or to the [https://lists.osgeo.org/listinfo/grass-dev grass-dev mailing list], [https://github.com/OSGeo/grass/discussions GitHub Discussions], or [https://gitter.im/grassgis/community Gitter] if you want to discuss them more. To edit this wiki, you need to [https://trac.osgeo.org/grass/login login] with an [https://www.osgeo.org/community/getting-started-osgeo/osgeo_userid/ OSGeo Userid]; read also some [wiki:TracLinks help] for using Trac.''
+
+If you are a student you can suggest a new idea or pick up an existing one in any case write about it to [https://lists.osgeo.org/listinfo/grass-dev grass-dev mailing list],[https://github.com/OSGeo/grass/discussions GitHub Discussions], or [https://gitter.im/grassgis/community Gitter].
+
+''You are invited as well to have a close look at (and re-suggest!) ideas from previous years ([https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2007 2007], [https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2008#Ideas 2008],
+[https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2009#Ideas 2009], [https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2010#Ideas 2010],
+[https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2011#Ideas 2011], [https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2012#Ideas 2012],
+[https://grasswiki.osgeo.org/wiki/GRASS_SoC_Ideas_2013#Ideas 2013], [wiki:/GSoC/2014 2014], [wiki:/GSoC/2015 2015], [wiki:/GSoC/2016 2016],
+[wiki:/GSoC/2017 2017],
+[wiki:/GSoC/2018 2018],
+[wiki:/GSoC/2019 2019],
+[wiki:/GSoC/2020 2020],
+[wiki:/GSoC/2021 2021],
+[wiki:/GSoC/2022 2022])
+which have not yet been implemented.
+You can also look at accepted GRASS GSoC [wiki:GSoC projects from previous years] for an idea of scope.''
+
+''Include "GRASS GIS" in the title of our idea to easily distinguish ideas and projects inside OSGeo.''
+
+<!--
+''Some bigger ideas may have their own pages, so you can link them here. The pages can be either independent if the page already exists (e.g. `wxGUIDevelopment/SingleWindow`), or more preferably subpages of this page if the idea is (re-)developed for this GSoC. In the later case, use the word "idea" in the page name to distinguish the idea page (e.g. `GSoC/2023/CoolGRASSProjectIdea`) from the possible student project page (e.g. `GSoC/2023/CoolGRASSProject`).''
+-->
+
+
+
+=== Title of idea ===
+
+Description here
+
+* Requirements:
+* Project length: (175 or 350 hours) 
+* Mentor: 
+* Proposed by: 
+* Rating: 
+* Expected Outcomes:  
+* Test of skills: 
+* Other: 
+
+
+=== Parallelization of existing modules ===
+
+There are several modules that would benefit from parallelization with OpenMP, e.g. r.texture, r.fill.stats, r/v.surf.idw, r.viewshed, v.to.rast, r.grow.distance,...
+For overview of current state, see https://grasswiki.osgeo.org/wiki/Raster_Parallelization_with_OpenMP.
+
+* Requirements: familiarity with C, OpenMP
+* Mentor: Huidae Cho
+* Co-mentor: Vaclav Petras, Anna Petrasova
+* Project length: 175 or 350 hours (take your pick)
+* Rating: medium
+* Expected Outcomes: parallelized module or modules, depending on complexity
+* Test of skills: https://github.com/OSGeo/grass/issues/2118
+
+=== Improve GRASS user experience in Jupyter Notebook ===
+Python package grass.jupyter was developed during [https://trac.osgeo.org/grass/wiki/GSoC/2021/JupyterAndGRASS GSoC 2021] to simplify running GRASS from Jupyter Notebooks and displaying data. This project could focus on adding features such as:
+  * animating series of maps (currently we can animate only temporal datasets)
+  * add parallelization for rendering
+  * increase interactivity of displayed data using ipyleaflet, e.g., capture mouse clicks to show information about vector line, pixel
+  * add API for managing projects and subprojects (i.e., locations/mapsets)
+  * simplify display of attribute data
+
+* Requirements: Python
+* Mentor: Vaclav Petras
+* Co-mentor: Anna Petrasova, Helena Mitasova
+* Project length: 175 or 350 hours (take your pick)
+* Rating: easy to medium
+* Expected Outcomes: improved user experience when using GRASS through notebooks
+* Test of skills: https://github.com/OSGeo/grass/issues/2688, or write a testsuite for a GRASS GIS command, more info [https://grass.osgeo.org/grass-devel/manuals/libpython/gunittest_testing.html here].
+
+=== Support writing tests with pytest ===
+
+* The current testing framework, ''grass.gunittest'', was written before migration to !Git/GitHub and when long free runs in 3rd party services were unthinkable. Additionally, some no longer relevant goals were prioritized, such as independence on the current code, detailed custom HTML reports, success tracking over time, and high specialization towards GRASS-specifics.
+* ''grass.gunittest'' is based on Python ''unittest'' package and many projects since then migrated to //pytest//, e.g., GDAL and Numpy. While ''unittest'' is inspired by Java's JUnit, ''pytest'' is designed to support writing small, readable tests, and uses plain `assert` statements instead of many different assert methods.
+* Using ''pytest'' should lead to tests which feel more like Python scripts and to minimum of testing-specific code.
+* An example issue of ''grass.gunittest'' is that it doesn't work well with tests of the main GRASS executable (prominence of `grass ... --exec` is yet another new thing which changed since ''grass.gunittest'' was designed).
+* Two main things needed:
+  - Create general comparison functions from the ''grass.gunittest'' assert methods so that they can be used with pytest.
+  - Current grass.script.setup.init function and grass.script.core.create_location function don't work well in the context of a pytest test function. More  
+* Additional things needed:
+  - Fixture for pytest to set up and tear down a GRASS session in a temporary mapset.
+
+* Requirements: Python
+* Project length: 175 or 350 hours (take your pick)
+* Mentor: Vaclav Petras
+* Co-mentor: Stefan Blumentrath
+* Proposed by: Vaclav Petras
+
+* Rating: easy to medium
+* Expected Outcomes: Convenient way of writing tests with pytest
+* Test of skills: Fix failing tests and/or write new tests (more is better). Alternatively, addressing a smaller problem in the testing framework is a good task, too.
+
+=== Improved color management in GRASS GIS ===
+
+Current color management of raster and vector maps has several issues:
+* Interactive editing of colors is rather limited: #3370
+* We can't easily specify discrete color intervals (e.g. [http://soliton.vm.bytemark.co.uk/pub/cpt-city/cb/seq/tn/BuPu_09.png.index.html this ramp]) for floating point data unless we reclass first, legend does not display that correctly
+* [https://trac.osgeo.org/grass/query?status=!closed&keywords=~colors and others...]
+
+A new color editing widget could be developed that would be integrated in r.colors, r3.colors, v.colors, t.rast.colors. It would allow simple editing of breaks (manual and automatic). Better support for discrete color tables for floating point data needs to be developed.
+
+* Requirements: Python, wxPython, possibly some C
+* Project length: 350 hours
+* Mentor: Anna Petrasova, Vaclav Petras
+* Co-mentor: Helena Mitasova, Stefan Blumentrath
+* Proposed by: Anna Petrasova
+* Rating: medium
+* Expected Outcomes: More user-friendly color management
+* Test of skills: [https://trac.osgeo.org/grass/query?status=!closed&keywords=~colors solve one of the color issues]
+
+
+
+=== New easy-to-use CLI and API for GRASS GIS ===
+
+ * Make running of GRASS GIS modules as easy as it is to run GDAL commands.
+  * `grass run r.slope.aspect elevation=elevation.tiff slope=slope.tiff aspect=aspect.tiff`
+  * CLI like GDAL has.
+  * No GRASS Database, Location, Mapset to deal with.
+  * No import, export from user perspective.
+  * Reasonable defaults for things like region.
+  * CLI and API still allows user to specify any of the above.
+ * Idea page with details: wiki:GSoC/2021/EasyToUseCliAndApiIdea
+ * Project length: 350 hours
+ * Rating: medium
+ * Requirements:
+  * Language: Python
+  * Proposal: Student needs to show sufficient understanding of the GRASS GIS Database structure and significantly extend on text below in terms of more concrete formulation of ideas and identification of missing and existing parts.
+ * Mentors: Vaclav Petras
+ * Co-mentors: Stefan Blumentrath
+ * Proposed by: Vaclav Petras
+ * Expected outcomes: New subcommand which easily runs a GRASS module on GeoTiff and GeoPackage.
+ * Test and training tasks:
+  * Solve one of the tickets linked at the idea page.
+  * Add features to `grass` executable interface:
+   * Make it possible to associate `*.gxw` files with `grass` executable (#1204) or at least add `--gui-workspace` or preferably just recognize it in the command line (distinguish it from database/location/mapset).
+  * Extend `--exec` functionality:
+   * Add `--region` to set a temporary computational region for the execution, e.g. `--region="raster=raster_name"`
+   * Add `--import-raster=some/file.tiff` which imports (r.import) a raster file (same for vector and similarly for export).
+   * Add `--link-raster=some/file.tiff` which links (r.external) a raster file (same for vector and similarly for r.external.out).
+
+=== Add {your research idea} to GRASS GIS ===
+
+ * In general, you can propose any topic, but you can specifically propose integrating your research or research idea into GRASS GIS.
+ * Requirements:
+   * Language:
+     * Depends on the project, often Python, sometimes C.
+     * Adding your latest ecological analysis 
+   * Proposal:
+     * Discuss relevance to GRASS GIS.
+     * Describe technical steps needed for integration.
+     * Describe whether it is an addition of a tool (module) or a change in one of the libraries. If it is a tool, specify if it should be included in the core grass repository or in grass-addons repository and why.
+     * Specify what research was done and what needs to be accomplished in order to have usable product at the end of summer.
+     * Specify who will provide the research expertise.
+ * Project length: 175 or 350 hours (take your pick)
+ * Rating: from low to hard
+ * Mentors:
+   * GRASS GIS project will provide technical mentors, but it is up to the applicant to ensure the research part is mentored well. An exception may be granted to applicants which can demonstrate that the research is finished or that they have enough expertise themselves.
+   * Possible technical mentors: Vaclav Petras, Anna Petrasova
+   * Research mentors: Bring in an expert from your field, e.g., your academic advisor or project principal investigator (if needed).
+ * Proposed by: Vaclav Petras
+ * Expected outcome: Working feature which is integrated and merged at the end of the project.
+ * Test and training tasks:
+   * Create a test in Python for an existing tool in the grass-addons repository or in the core grass repository.
+== Tips for students ==
+
+ * If you have your own ideas we encourage you to propose them. Explain them on the [https://lists.osgeo.org/listinfo/grass-dev grass-dev mailing list].
+ * If you like some idea here or from previous yeas, write about it on [https://lists.osgeo.org/listinfo/grass-dev grass-dev mailing list] and any ideas of your own which could improve it.
+ * Follow some good practices in your ideas and proposals:
+  * Stress why the project would be useful.
+  * Show that you know how you will proceed. That is, make sure that you can demonstrate that the proposal is feasible in the given time frame.
+  * Be specific in the implementation (or at least as specific as you can).
+  * Explain what the final product will look like and how it will work. You can add drawings or mock-ups.
+  * Explain how the idea relates to existing GRASS GIS functions, features, and needs.
+  * Do not include steps such as "install GRASS", "compile GRASS libraries (on my machine)", "read about the API". You should do this before applying to GSoC.
+ * Compile GRASS GIS 8 from source and prepare environment for development:
+  * Read [https://github.com/OSGeo/grass/blob/main/CONTRIBUTING.md CONTRIBUTING file] and [https://grasswiki.osgeo.org/wiki/Compile_and_Install compilation instructions].
+  * If you get stuck with the setup, feel free to consult the [https://lists.osgeo.org/listinfo/grass-user grass-user mailing list].
+  * Familiarize yourself with wiki:Submitting rules.
+ * Prove your worth by being active on the GRASS mailing lists ([https://lists.osgeo.org/listinfo/grass-user grass-user], [https://lists.osgeo.org/listinfo/grass-dev grass-dev]) or other channels ([https://github.com/OSGeo/grass/discussions GitHub Discussions], [https://gitter.im/grassgis/community Gitter]), fix some [https://github.com/OSGeo/grass/issues bugs], and/or implement some (smaller) features, or write some (simpler) GRASS module, and post it to mailing list. There's no better way to demonstrate your willingness and abilities. Do this before start you apply to GSoC. 
+ * Also note that fixing existing bugs and/or implementing enhancements will be a part of student evaluation.
+
+ * Every year GRASS GIS hopes to participate and participates in GSoC as part of the [https://www.osgeo.org/ OSGeo Foundation]'s GSoC program umbrella. See the official OSGeo template for application details and other important information at the [https://wiki.osgeo.org/wiki/Google_Summer_of_Code_Recommendations_for_Students OSGeo Recommendations for Students].