mainGNU Astronomy Utilities - Support: sr #110195, Google Summer of Code (GSoC) 2020

 
 

sr #110195: Google Summer of Code (GSoC) 2020

Submitter:  Mohammad Akhlaghi <makhlaghi>
Submitted:  Fri 14 Feb 2020 02:15:31 PM UTC
   
 
Category:  All Gnuastro Priority:  5 - Normal
Severity:  3 - Normal Item Group:  * Enhancement
Status:  Done Privacy:  Public
Assigned to:  makhlaghi Open/Closed:  Closed
Operating System:  None
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Fri 12 Mar 2021 10:52:57 PM UTC, comment #45: 

For GSoC 2021, please see sr #110457 and post comments there.

I am closing this issue to help a clean discussion there.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Fri 12 Mar 2021 02:51:09 AM UTC, comment #44: 

I am happy to say that the two Gnuastro GSoC 2021 projects are now on OpenAstronomy and you can apply :-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 11 Mar 2021 01:13:09 AM UTC, comment #43: 

It was indeed a surprising situation that GNU wasn't accepted as an organization this year! But Mosè Giordano just made a good suggestion: Gnuastro is also a member of Open Astronomy, which has been accepted as an organization.

So I will try to add the suggested ideas in Open Astronomy's webpage (hopefully its not too late to add ideas there!). I will update you with another post here if everything goes well.

So all hope is not yet lost for this year ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Wed 10 Mar 2021 09:36:32 AM UTC, comment #42: 

Hi Amey,

The GNU project was not selected this year as an org for GSoC'21 :(

But if you still want to contribute, you can see the task and bugs and start with any simpler ones and make your way through the codebase. We have a dedicated manual (https://www.gnu.org/savannah-checkouts/gnu/gnuastro/manual/gnuastro.pdf) that can help you to get started and also has a Library section with all the High-level library defined.

The codebase is heavily commented so it can be easy to understand as you go through it. Please reach out if you have any further queries. Thanks for your interest :)

Sachin Kumar Singh <sks_15>
Wed 10 Mar 2021 03:55:12 AM UTC, comment #41: 

Hello everyone, I am Amey, a Computer Science Undergraduate. I have previously worked in C/C++, Python. How should I get started with understanding the code and contributing. I have worked in Mathematics, Machine Learning, Algorithms in general


Amey Varhade <ameyvariitg>
Fri 02 Oct 2020 07:42:15 AM UTC, comment #40: 

Hi Pedram,

Have you had a look at the Known-issues section? There are some solutions in there for similar problems regarding configuration, compilation and tests. :-)

Sachin Kumar Singh <sks_15>
Thu 01 Oct 2020 11:29:16 PM UTC, comment #39: 

It is strange that you had to install CFITSIO before being able to run 'testprog'! It is against the whole purpose of the test (you should test a software and see if it works before installing it!

But generally, this support item is mostly for very general introductory issues, its best to discuss detailed technical issues in their own separate "tasks" and "bugs". So can you please post this as a bug, while also showing the error that happens when you don't have CFITSIO installed?

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 01 Oct 2020 04:03:54 PM UTC, comment #38: 

comment #3 and comment #4

I guess the command execution order in gnuastro manual is wrong. It looks like one has to install the CFITSIO first and call the testprogram after that. Notably, this is how I tried it and it worked out just fine:


$ tar xf cfitsio_latest.tar.gz
$ cd cfitsio-X.XX                   # Replace X.XX with version
$ ./configure --prefix=/usr/local --enable-sse2 --enable-reentrant
$ make
$ make utils # just to make sure everything is there
$ rm cookbook fitscopy imcopy smem speed testprog # so it won't install extra stuff
$ sudo make install # install first
$ make utils # produce the test files, etc again
$ ./testprog > testprog.lis
$ diff testprog.lis testprog.out    # Should have no output
$ cmp testprog.fit testprog.std     # Should have no output



Pedram Ashofteh-Ardakani <pedram>
Group Member
Wed 23 Sep 2020 10:27:47 PM UTC, comment #37: 

Indeed, follow those instructions that Sachin mentioned and don't hesitate to ask anything that is not clear, or any problem you may encounter. I look forward to merging your first commit into Gnuastro :-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Wed 23 Sep 2020 07:49:21 AM UTC, comment #36: 

Hi Apoorva,

It's great to know that you're interested in contributing to GNU Astro. The first thing you should do is to play with the software a bit and get a basic gist of it. I'll recommend you to go through the GNU Astro manual here. It has sections dedicated to installing and awesome tutorials that you can follow. If there is any problem, feel free to reach out:-)

Also, have a look at comment #14 where Mohammad has explained the various steps to help you get started.

Sachin Kumar Singh <sks_15>
Wed 23 Sep 2020 04:28:44 AM UTC, comment #35: 

I'm interested in contributing to GNU Astro Project. I'm quite proficient in C and C++. Please guide me how should I get started.
Thanks



apoorva <mittalapoorva>
Fri 24 Jul 2020 11:20:25 PM UTC, comment #34: 

Here is my first blog for the GSoC'20. I report my progress and the tasks done here until the first evaluation.

https://sachinkumarsingh092.github.io/blog/gsoc-post1

Sachin Kumar Singh <sks_15>
Thu 19 Mar 2020 07:13:07 PM UTC, comment #33: 

A few other small points about the proposal:

  • For connection with the mentor besides email, you can mention Savannah: the way that I am already communicating with many of you on specific tasks.
  • For evaluations, you need to set milestones/deliverables. For example say that "I will complete job AAA in the first evaluation round, job BBB in the second evaluation" and etc. Try to break up your final goal into smaller pieces that be delivered earlier.


I am sure there must be many guides and templates on writing a good GSoC proposal on the internet, so please look around at those resources also ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 19 Mar 2020 06:28:25 PM UTC, comment #32: 

Since a few of you asked about suggestions on a good proposal, I thought of posting a general comment here.

To start with, let me say that this it the first time I am mentoring in GSoC, and that I have no experience as a student before this. So please review other resources is well, in particular the GSoC student guide.

The first point is that you don't have to focus on a single task/bug here on Savannah! At a high-level they are independent, but as go to a lower-level, they have many things in common. You can thus can include multiple tasks in your proposal. But don't just choose a random list, or just list them. Build the body of your proposal around the common lower-level theme of the tasks you want to do, then cite the tasks.

The most important thing is that you don't need to get into too much technical detail of the code in the proposal. Those of you who have already committed code in the master branch (or are waiting for the copyright forms to complete so it be merged) can just point to your commits in the master branch and describe your experience in doing that. Use this to show that you understand the code-base of Gnuastro and that you know what you are talking about ;-)!

Please consider that the referee(s) won't have more than a few minutes to read your proposal, if you get too technical, you will loose him/her: since s/he doesn't have time to understand what you are trying to say.

So focus on 1) a good introduction to highlight the importance of your project for the astronomical community (I think in the task descriptions there are enough links to places you can cite). 2) show that you know the code structure and workflow of Gnuastro, and that you have the technical abilities to do the task. 3) Describe (generally) how you intend to solve the problem without getting too much into details (while showing that you know what you are talking about).

I hope this helps ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 19 Mar 2020 06:08:48 PM UTC, comment #31: 

Thank you very much Saif, I am really happy to hear that you are interested in Gnuastro.

Indeed, play with it a little (the tutorials are a good start), and don't hesitate to bring up anything that is not clear, or you think can be improved. Hopefully that list can be used to find good places to contribute ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 19 Mar 2020 03:44:48 PM UTC, comment #30: 

Hi! The GNUAstro project sounds really cool to me! Always had a kind of fascination with astronomy and space since I was in school.

I may not be able to be a part of the GSoC since I'm trying to take part in another project, but this seems like a project that I would like to contribute on for the sake of it.
I've the read suggestions below for setting up and playing around with GNUAstro to get a good feel for it. That's definitely what I'll be doing.

Hoping I can make some good contributions to this project. I'll keep checking around this page.
Thank you, and have a nice day. :)

Saif Ul Islam <rubix982>
Tue 03 Mar 2020 05:34:29 PM UTC, comment #29: 

That is great Kartic. Can you please move the discussion to task #15567?

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 03 Mar 2020 01:11:53 PM UTC, comment #28: 

I am interested in working on it but since I am unable to build GNUAstro from source, how should I begin work on it ?

Kartik Ohri <lucifer13>
Tue 03 Mar 2020 12:35:58 PM UTC, comment #27: 

I just added a new task for Gnuastro which is relatively easy to implement (task #15567). Essentially, its just a parsing of a standard string format and converting it to a double precision floating point.

If anyone is interested, it can be a good way to start digging into coding of Gnuastro ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 03 Mar 2020 10:53:37 AM UTC, comment #26: 

madhav_bansal, as I asked before, please keep this thread only for general GSoC discussions. Please open a bug/task report for technical discussions on a specific issue ;-).

As a fast answer, I'll look into the "pstools" issue, thanks for bringing it up (it may have been a recent update in TexLive). About the error message, it clearly says that you are missing the GNU Texinfo package or ut can't find it. Please try to reinstall it and if the lroblem persists, open a bug so we can have a more detailed discussion without crowding this GSoC thread!

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 03 Mar 2020 09:43:08 AM UTC, comment #25: 

In the documentation, It is written to install the "pstools" package in bootstrapping dependencies but that package doesn't exist but it worked for "pstool". but now I am having trouble in running make -j8.
getting this error:
WARNING: 'makeinfo' is missing on your system.
         You should only need it if you modified a '.texi' file, or
         any other file indirectly affecting the aspect of the manual.
         You might want to install the Texinfo package:
         <http://www.gnu.org/software/texinfo/>
         The spurious makeinfo call might also be the consequence of
         using a buggy 'make' (AIX, DU, IRIX), in which case you might
         want to install GNU make:
         <http://www.gnu.org/software/make/>
Makefile:1992: recipe for target 'gnuastro.info' failed
make[3]: * [gnuastro.info] Error 127
make[3]: Leaving directory '/home/madhav/Desktop/gsoc/vrsngnuastro/gnuastro/doc'
Makefile:1951: recipe for target 'all' failed
make[2]: * [all] Error 2
make[2]: Leaving directory '/home/madhav/Desktop/gsoc/vrsngnuastro/gnuastro/doc'
Makefile:2099: recipe for target 'all-recursive' failed
make[1]: * [all-recursive] Error 1
make[1]: Leaving directory '/home/madhav/Desktop/gsoc/vrsngnuastro/gnuastro'
Makefile:1989: recipe for target 'all' failed
make: * [all] Error 2



madhav_bansal <madhav_bansal>
Tue 03 Mar 2020 02:22:56 AM UTC, comment #24: 

To madhav_bansal (Comment #22), Can you please post more details on the problem with `tlmgr' as a Bug? You can do this by hovering over the "Bug" item above and selecting "Submit new".

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 03 Mar 2020 02:19:58 AM UTC, comment #23: 

To Anonymous (Comment #21), Thank you very much for your interest. The level of C required highly depends on the operation you want to do ;-), but generally, if you know the basic K&R C you should be able to follow Gnuastro's code. In some parts, more modern features like threads are also necessary, but they aren't too complex (for example, we use the simple POSIX Threads model: `pthreads').

About the question of "Where to start", please see the previous post in Comment #14 ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Mon 02 Mar 2020 03:32:12 PM UTC, comment #22: 

I have downloaded the version-controlled source but having problem in downloading the dependencies of bootstrapping, specifically the command shown in the documentation  for installing the tex packages
command:-
tlmgr install epsf jknapltx caption biblatex biber iftex \
                etoolbox logreq xstring xkeyval pgf ms     \
                xcolor pgfplots times rsfs pstools epspdf

madhav_bansal <madhav_bansal>
Mon 02 Mar 2020 11:52:20 AM UTC, comment #21: 

Hello,
I would like to help with Image Processing for GNU Astronomy for GSoC. What level of C programming knowledge is needed? From where can I start so I can have a god image about GNU Astronomy?

Anonymous
Wed 26 Feb 2020 12:54:28 PM UTC, comment #20: 

This is Great! It will be very useful for the Julia API project. Thanks a lot Mose.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Wed 26 Feb 2020 12:12:05 PM UTC, comment #19: 

On the Julia side, I built Gnuastro 0.11 for the following platforms:

  • i686-linux-gnu
  • x86_64-linux-gnu
  • aarch64-linux-gnu
  • arm-linux-gnueabihf
  • powerpc64le-linux-gnu
  • i686-linux-musl
  • x86_64-linux-musl
  • aarch64-linux-musl
  • arm-linux-musleabihf
  • x86_64-apple-darwin14
  • x86_64-unknown-freebsd11.1


Now getting Gnuastro from within Julia is as easy as installing the package called `Gnuastro_jll`.  If one wants to use their own installation of Gnuastro, Julia offers a simple mechanism to opt-out the binaries that it would provide by default.

The `Gnuastro_jll` package provides functions to directly call the Gnuastro programs from Julia.  At this point, we only need someone to write the Julia wrapper for the library ;-)

Mosè Giordano <giordano>
Group Member
Tue 25 Feb 2020 05:26:09 PM UTC, comment #18: 

Indeed, that would be great Mose ;-)! I also saw all the bugs you posted about cross compiling and will look into them. Until now, I have just use Debian's build farm for checking other architectures.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 25 Feb 2020 02:28:46 PM UTC, comment #17: 

Uh, I didn't realise there was a GSoC project for writing a Julia wrapper, I can help you out with that one.

Relatedly, I'm trying to cross-compile gnuastro for all platforms supported in Julia but I get failures in a couple of them, I'll need to take the time to look at the failures and open an issue here.

Mosè Giordano <giordano>
Group Member
Tue 25 Feb 2020 02:02:43 PM UTC, comment #16: 

Hi, thanks for your interest ;-). A Julia API for the Gnuastro library will indeed be very useful, its great you are interested in contributing in this project.

About the bootstrapping problem, it may be better to post it as a "Bug". Now that you are a member on Savannah, you can just hover your mouse over the "Bugs" menu on top of this page, and click on "Submit New" to post the bug and describe the problem.

This will help keep this list only on the GSoC discussions ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Tue 25 Feb 2020 01:27:51 PM UTC, comment #15: 

Hi, I am interested in working with GNUASTRO in GSoC 2020. I am particularly interested in writing a Julia wrapper for GNUASTRO library.

I trying to install GNUAstro from the version controlled source but am facing a few issue in it. Is this the right place to ask for help regarding that ?

Kartik Ohri <lucifer13>
Sun 23 Feb 2020 07:41:05 PM UTC, comment #14: 

RECOMMENDED STEPS TO START DEVELOPING IN GNUASTRO

This is for those interested in participating in Gnuastro's development. The basic point is that you should first install and run the programs to get a feeling of their over-all purpose and usage, then start getting your hands dirty into the coding. The following list should be a rough guide on how to do this.

  1. Install the dependencies. In particular, if you use the most common GNU/Linux operating systems, to start with, we recommend using your package manager. Later, when you get more advanced, you can install them from source also.
  2. Install the latest Gnuastro from the officially released tarball and install it as described in the Quick start.
  3. There is a full chapter on tutorials, if you have time go through all of them, if not, the general tutorial should be enough. It is a little long, but shouldn't take more than three or four hours. You don't necessarily have to understand the science behind the steps, but try to open the images (inputs and outputs). This tutorial touches upon most Gnuastro programs will give you a very good feeling of it (and thus help you develop good ideas to write in the GSoC proposal.
  4. Having done the tutorial, you may have your own ideas on what to improve, or you can have a look at the list of bugs or tasks. Some more easier tasks are task #15317, task #15138, task #15136, task #15109, task #15053, task #14986, task #14908, task #14760, task #14643, task #14419, task #14409, task #14364. If they aren't already taken, you can post a comment on the task and start focusing on it.
  5. You are now ready to start developing. But you will need the version controlled source, which needs to be bootstrapped. And bootstrapping has its own dependencies. So install the bootstrapping dependencies, then follow the bootstrapping guide to prepare the raw source for building/developing. After bootstrapping, you can configure and install Gnuastro's version controlled source just like the tarball.
  6. Depending on the task/bug that you have selected to work on, please read the description of that particular program. For example if the bug/task is related to the Crop program, read the Crop section of the manual. This will give you an over-all feeling of the overall working style of the program and help guide you mentally when you are reading the source.
  7. Read the Developing chapter of the Gnuastro manual. Please read this section carefully because it will really help you get a smooth start on the source code and our style. In particular the Program source section describes the common structure of files and programming structure of the programs. Don't forget to read the other sections of this chapter too ;-)!
  8. Build you own fork of Gnuastro (as described in the Forking tutorial.
  9. If you are fixing a bug, please try to reproduce it.
  10. Go into the source of the program you want to work on, and start reading the code from `main.c' (which has the starting `main()' function). Follow the functions and comments until the end of the program (beware that some programs can be large and complex, you can usually tell this by the number of files in its source directory).
  11. Once you have a nice mental image of the program, you are ready to start working on your selected bug/task.
  12. Please don't hesitate to ask any GSoC (general) question here, but if your discussion is about a certain task/bug, please don't post it here, use the bug/task's own page.
Mohammad Akhlaghi <makhlaghi>
Group administrator
Sun 23 Feb 2020 04:28:53 PM UTC, comment #13: 

Sorry for such raw commit messages but I made it small as it was only for review purposes. I was indeed going to rebase it later. But I get the message. I'll try to be more descriptive even for any mutual discussions:-)

Sachin Kumar Singh <sks_15>
Sun 23 Feb 2020 03:53:48 PM UTC, comment #12: 

Thanks for continuing the discussion on task #15109 Sachin. I just pulled your clone will have a closer look later.

I'll try to give more detailed feedback on that particular task later, since I am busy now. But before that, let me just make some general notes which I am putting on the GSoC discussion for others to also see.

Every project usually has a commit-message culture. Before making commits (and writing the commit message) its good to run `git log' and seeing the previous commits to get a sense of this "culture". Please do this in Gnuastro's source and read some previous commit messages to see what I mean.

As you see, the case of Gnuastro, it is really important to be very elaborate in the commit message. Infact there is a full section on Commit guidelines in the "Developing" chapter. The basic idea is that we want people to be able to follow the history by reading the commit messages without necessarily understanding the code. In fact, most of the discussion should go on in the commit messages, not on Savannah or GitHub or GitLab and etc, because the commit messages stay in the history, but text written here are separate.

Ofcourse, if you like to make really small commits, you can keep them like this, then when they are large enough to actually merge, you can rebase them into one commit and do a full description there. In this case I think it would also be necessary because I noticed you had committed your SSH public key into the Gnuastro history ;-). But even in this case, its good for the one-line commit message to be descriptive. I see that more than one commit is simply called "size operator", which isn't good ;-).

Another important point is that there should be no lines with empty white-space lines. I see two lines with just spaces under your commit f89757d31, the `arithmetic_size' function has two lines that only have white space characters. You don't see it on GitHub, but if you do a simple `git log' on your command-line you should see them.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Sun 23 Feb 2020 02:26:52 PM UTC, comment #11: 

This seems to be a very good progress Sachin! But just two things:

1. Discussion on the particular task should be done under that task, not here ;-). Here we just want to have general GSoC discussions prior to choosing a special task.

2. Have you tried adding the changes in the code (on a new Git branch), compiling it and trying the new operator? The best way to see what to do is usually to start compiling the changes and seeing the result. When its not yet complete, you can just put a `printf' statement and fill it gradually. This is also easier for me to check: I can just pull your branch, try it out and give more practical comments.

But anyway, let's move the discussion on this special task to its own page ;-).

Arithmetic has become one of the most widely used programs in Gnuastro, so its great that you are mastering it, we look forward to adding many more operators.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Sun 23 Feb 2020 07:45:05 AM UTC, comment #10: 

My plan is to use the HDU metadata to extract the values of keywords 'NAXISn' for the required operand. If the above implementation is faulty please suggest the idea for a correct one.

Sachin Kumar Singh <sks_15>
Sun 23 Feb 2020 07:38:23 AM UTC, comment #9: 

I've made the following changes in the following files but there are a few doubts:

  • I've made a macro `GAL_ARITHMETIC_OP_SIZE` in lib/arithmetic.h.


In lib/arithmetic.c:

  • I've made a `size` function


/* what should be the data type of the function. I've used  the general one */
static gal_data_t *
arithmetic_size (int operator, gal_data_t* input){
  size_t *dsize=input->dsize;

  if(operator)
  {
    // how to return return dsize for the required operand;
  }
  else
  {
    error(EXIT_FAILURE, 0, "%s: operator code %d not recognized",
            __func__, operator);
    // how to return EXIT_FAILURE or something like that.
  }
}


  • Added `else if (!strcmp(string, "size"))

    { op=GAL_ARITHMETIC_OP_SIZE;              *num_operands=1;  }`

in gal_arithmetic_set_operator.

  • Added `case GAL_ARITHMETIC_OP_SIZE:            return "size";` in gal_arithmetic_operator_string.


  • added


    case GAL_ARITHMETIC_OP_SIZE:
      d1 = va_arg(va, gal_data_t *);
      out=arithmetic_size(operator, d1);


in `gal_arithmatic`.

I've another idea to use `gal_fits_key_read` but that seems to be an overkill for this simple problem. But I'm open to any suggestions.

What are other things I need to change and are the current changes right? What else is to be done? What are the things I'm getting wrong?

Any suggestion?

Sachin Kumar Singh <sks_15>
Thu 20 Feb 2020 05:17:09 PM UTC, comment #8: 

Just to conclude the discussion on the workflow for developing Gnuastro.

Once you run the three commands above, you'll have a debug-ready built Gnuastro in the `build' directory of the source (which is actually a symbolic link to your RAM). With the built files in that directory, you can navigate a clean source directory.

Then you start editing the programs and adding/removing things.

After every change, you just have to run the `./tests/during-dev.sh' script. It will compile the changed parts and try running your test command, allowing you to test if you change does what you intended or not ;-).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 20 Feb 2020 05:12:23 PM UTC, comment #7: 

Great! I also think you have selected a relatively simple task. Once you understand the logic of the Arithmetic program's implementation (which isn't hard), it should be trivial to do :-). It may also help if you look into the Arithmetic section of the book.

Did you see the program source section part of the Developing chapter? That should help you navigate the general/common structure of the source files of each program.

So for example, to start modifying the code of the Arithmetic program, you will find its source under the `bin/arithmetic' directory. Reading this section actively (while also opening the relevant file in the code and looking into it for the things you read) should be enough to get you started. Then you can simply start from the program's `main.c' file (which hosts the program's `main()') and read along to follow the flow of the program and understand the algorithms. It is all very basic C and heavily commented.

About the new files added after bootstrapping Gnuastro: we have instructed Git (through `.gitignore') to ignore them. So after bootstrapping is done, if you run `git status', it should say that everything is clean. If its not, its a bug and we should fix it ;-).

As a developer in Gnuastro, after bootstrapping, you may also like to use the `developer-build' and `tests/during-dev.sh' script in the top directory. Run them with `--help' to see all their steps, or better-yet, open them and read through them (they are HEAVILY commented). It simplifies the job of the developer.

For example, when I want to fix a bug or add something, I do this on a clean commit that hasn't yet been built)


./developer-build -d
emacs tests/during-dev.sh
./tests/during-dev.sh


(Ofcourse, you can edit the `tests/during-dev.sh' script with any text editor you like ;-)).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Thu 20 Feb 2020 11:15:08 AM UTC, comment #6: 

I've read all the suggested portion of the manual, mainly tutorials and contributions, and I'm ready to dive into the codebase. I've cloned the repository and pushed a new branch to GitHub.

Task #15109 seems to be a good one to start, though I'll really appreciate if an even simpler task is suggested. With all that done, what are the files I should look into for making changes and adding features and how should I start? What are the things to be considered for the above task?

After bootstrapping many library and files(executables and binaries) will be included which are undesired when pushing the changes to the remote repository. Is there any option in `make` for cleaning those before pushing?

Also, how should I check my changes? Should I use `make` after every change or is there a smarter way?

Thanks in advance:)


Sachin Kumar Singh <sks_15>
Sun 16 Feb 2020 03:35:43 PM UTC, comment #5: 

By the way, the full instructions to build the dependencies are available in the Gnuastro manual (for example see the WCSLIB subsection). It may be easier to follow these instructions as you start  than the actual manual of the tools (which can be overwhealming).

Also, to avoid unnecessary frustration at the start, it may be easier to just use your package manager. Later, when you get more advanced and start seeing their limitations, you can start building the dependencies from source yourself.

Mohammad Akhlaghi <makhlaghi>
Group administrator
Sun 16 Feb 2020 09:32:52 AM UTC, comment #4: 

This is a standard error with the shared libraries at run-time. It is explained in the known issues section of the Gnuastro manual (it can also happen to the build of Gnuastro). See the part where we export LD_LIBRARY_PATH. that should fix this problem   


Generally having a good to understandong of the various "PATH"s and their relations with libraries and programs is very helpful and there aren't too many good resources on them. So I tried to explain them in the Gnuastro manual: please read the Installation directory and Review of library fundamentals (and its sub-sections) parts of the Gnuastro manual carefully to hopefully never have such problems in the future (for any program/library).

Mohammad Akhlaghi <makhlaghi>
Group administrator
Sun 16 Feb 2020 06:58:04 AM UTC, comment #3: 

I tried to install the WFITSIO library from their official tarball using their documentation in GNU/Linux. The building and making steps were completed without any errors. But during the testing step the following error showed up:
./testprog: error while loading shared libraries: libcfitsio.so.8: cannot open shared object file: No such file or directory

But libcfitsio.so.8 is there in the folder(as a symbolic link). I googled the error but couldn't find anything useful and also inquired on their official help desk but haven't got a reply back yet. I've tried various options of configure and make and also tried reinstalling but the problem still persists.

Finally, I installed the library from my package manager (apt) but I doubt it was compiled with multithreading options so I want to fix the above error. Any help is appreciated:)

Sachin Kumar Singh <sks_15>
Sat 15 Feb 2020 10:16:38 AM UTC, comment #2: 

If you just want to run Gnuastro, the officially released tarball may be the easiest solution. If you use the common GNU/Linux distributions, the commands to install the dependencies can be found in the manual.

Since its better to first play with a programs (to get a good feeling of the whole package), I recommend starting with the officially released tarball. In the manual there is a Tutorial chapter with some example scenarios of program usage. They don't need much astronomical knowledge and won't take much time to do (a day or two should be enough).

After going through the tutorial and running the commands and seeing the inputs/outputs, you want to start getting your hands into the underlying code. For that, you should use the version-controlled source.

But the version controlled source need to be bootstrapped, so it has some extra dependencies. They are also easy to install though ;-).

Generally, I would argue that the version controlled source is more stable (more bugs are fixed), but because it needs bootstrapping, it may be a little annoying at first (when you just want to play with the software).



Mohammad Akhlaghi <makhlaghi>
Group administrator
Sat 15 Feb 2020 07:52:24 AM UTC, comment #1: 

Hello,
Should I download Gnuastro from the version-control source or from the stable tar-ball release? I think VC source will have the most recent changes but will have stability problems, especially for someone trying it out for the first time, even though it is tested before pushing. Any recommendations?

Sachin Kumar Singh <sks_15>
Fri 14 Feb 2020 02:15:31 PM UTC, original submission:  

Gnuastro has proposed two projects for this year's Google Summer of Code (GSoc). Please feel to ask questions here. We'll also post relevant things (like easy bugs/tasks) here for interested applicants.

Mohammad Akhlaghi <makhlaghi>
Group administrator

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by ameyvariitg (Posted a comment)
  • -email is unavailable- added by pedram (Posted a comment)
  • -email is unavailable- added by mittalapoorva (Posted a comment)
  • -email is unavailable- added by rubix982 (Posted a comment)
  • -email is unavailable- added by madhav_bansal (Posted a comment)
  • -email is unavailable- added by giordano (Posted a comment)
  • -email is unavailable- added by sks_15 (Posted a comment)
  • -email is unavailable- added by makhlaghi (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 4 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2021-03-12 makhlaghi StatusNone Done
        Assigned toNone makhlaghi
        Open/ClosedOpen Closed
        SummaryGoogle Summer of Code (GSoC) discussions Google Summer of Code (GSoC) 2020

    Back to the top

    Powered by Savane 3.13-4448.
    Corresponding source code