Skip to content

Commit 59bc9be

Browse files
committed
updated documentation
1 parent dbbfc8f commit 59bc9be

File tree

2 files changed

+16
-9
lines changed

2 files changed

+16
-9
lines changed

README.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
# Star reduction in deep sky images
22

3-
Starrem2k13 is a simple and easy tool to remove stars from astronomical images. Starrem2k13 uses a GAN trained on augmented data. Code was inspired from a [sample at Tensorflow's website](https://www.tensorflow.org/tutorials/generative/pix2pix). The training data consists of only two images. One image of the Helix nebula and another is a starmap that was created from a star cluster image. Here is how the results look like:
3+
Starrem2k13 is a simple tool for removing stars from astronomical images. Starrem2k13 uses a GAN trained on augmented data. It's code was inspired from a [sample at Tensorflow's website](https://www.tensorflow.org/tutorials/generative/pix2pix). The training data consists of only three base images.
4+
5+
Below are examples of what it can do:
46

57
![images/example2.png](images/example2.jpg)
68

79
![images/example.png](images/example.jpg)
810

911

1012
# Installing
11-
Currently binaries for Windows, Linux and MacOS are available in the releases section. These were created using PyInstaller. Using pre-complied binaries is the recommended way of running Starrem2k13. Once you have downloaded and installed the program you can run it simply by typing the following in command prompt/terminal
13+
Currently binaries for Windows, Linux and MacOS are available in the releases section. These were created using PyInstaller. Using pre-complied binary is the recommended way of running Starrem2k13. Once you have downloaded and installed the program you can run it simply by typing the following in command prompt/terminal
1214

1315
```shell
1416
starrem2k13 image_with_stars.jpg image_without_stars.jpg
1517
```
1618

17-
## Running using Docker (Recommended)
19+
## Running using Docker (if binaries don't work)
1820

1921
```
2022
docker run -v $PWD:/usr/src/app/starrem2k13/data \
@@ -24,7 +26,7 @@ docker run -v $PWD:/usr/src/app/starrem2k13/data \
2426
Note that *$PWD* refers to your current working directory. In the above example it is assumed that the file *example.jpg* resides in your current working directory. This directory is mounted as a volume with the path */usr/src/app/starrem2k13/data* inside the docker container. The output image *example_starless.jpg* will also be written to same directory.
2527

2628

27-
## Running with local python installation
29+
## Running with local python installation (for geeks)
2830
Clone the repository and navigate to the 'starrem2k13' folder. Install required packages :
2931

3032
```shell

docs/index.html

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@
6161

6262
<img src="star2k13_video.gif" style="width:100%;max-width: 360px;" /> <br />
6363

64-
Starrem2k13, a simple, easy tool and open source for removing stars from deep sky images.
64+
Starrem2k13, a simple open source for removing stars from deep sky images.
6565
<br />
6666
<a class="btn btn-outline-secondary btn-sm" type="button"
6767
href="https://ashishware.com/static/star_removal/index.html">Try Online Demo <i
@@ -200,13 +200,12 @@ <h2 id="faq" class="mt-4">FAQ</h2>
200200

201201
<p>
202202
<span class="fw-bold">Where can I find source code for this tool?</span><br />
203-
The source code is available here : <a
204-
href="https://github.com/code2k13/starrem2k13">https://github.com/code2k13/starrem2k13</a>
203+
The source code is available <a href="https://github.com/code2k13/starrem2k13">here</a>
205204
</p>
206205

207206
<p></p><span class="fw-bold">Can I train my own model and use with this tool?</span><br />
208-
Yes you can, please refer to this section : <a
209-
href="https://github.com/code2k13/starrem2k13#training-model-on-your-images">https://github.com/code2k13/starrem2k13#training-model-on-your-images</a>
207+
Yes you can, please refer to <a
208+
href="https://github.com/code2k13/starrem2k13#training-model-on-your-images">this section.</a>
210209
</p>
211210

212211

@@ -219,6 +218,12 @@ <h2 id="faq" class="mt-4">FAQ</h2>
219218
model weights. When it runs, it needs to unpackage everything , which takes time.</p>
220219

221220

221+
<p><span class="fw-bold">How can I perform batch star removal?</span><br />
222+
Checkout the <a href="https://github.com/code2k13/starrem2k13/blob/main/batch_process.sh">simple shell
223+
script</a> from the project's repo. Since Starrem2k13 is a command-line utility,
224+
it can be used in many different ways.</p>
225+
226+
222227

223228

224229
</div>

0 commit comments

Comments
 (0)