Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add a depth description about Mapknitter in Readme #1067

Open
cesswairimu opened this issue Oct 7, 2019 · 6 comments · May be fixed by #1068 or #1077

Comments

@cesswairimu
Copy link
Collaborator

commented Oct 7, 2019

Description

@divyabaid16 wrote this awesome description about Mapknitter in the final report...It would be nice to have to on the repo. Thanks @divyabaid16 ❤️

This is a first-timers-only issue. This means we've worked to make it more legible to folks who either haven't contributed to our codebase before, or even folks who haven't contributed to open source before.

If that's you, we're interested in helping you take the first step and can answer questions and help you out as you do. Note that we're especially interested in contributions from people from groups underrepresented in free and open source software!

We know that the process of creating a pull request is the biggest barrier for new contributors. This issue is for you 💝

If you have contributed before, consider leaving this one for someone new, and looking through our general help wanted issues. Thanks!

🤔 What you will need to know.

Nothing. This issue is meant to welcome you to Open Source :) We are happy to walk you through the process.

📋 Step by Step

  • 🙋 Claim this issue: Comment below. If someone else has claimed it, ask if they've opened a pull request already and if they're stuck -- maybe you can help them solve a problem or move it along!

  • 📝 Update this file https://github.com/publiclab/mapknitter/blob/main/README.md by (press the little pen Icon) and edit the line as shown below.

  1. Below this line 7. License add
8. [Mapkitter in depth](#mapknitter-in-depth)
  1. At the end of this file add this piece of code

***

## Mapknitter in depth

MapKnitter is a free and open source software created and run by Public Lab. MapKnitter is hosted through a donation of server space byRackspace.

MapKnitter can make maps from any image source, but it particularly lends itself to making maps with balloons and kites. The manual process of making maps with MapKnitter differs greatly from automated aerial imaging systems. In those systems, the imaging is of higher precision and processed with spatial and telemetry data collected along with the imagery, typically at higher altitudes and with consistent image overlap in the flight path sequence.

With MapKnitter the cartographer dynamically places each image and selects which images to include in the mosaic. Although the approaches are similar in that they use some type of additional information (usually pre-existing imagery of a lower resolution) as a reference, and that they are bound to specific cartographic elements such as map scale and map projection

See this page for some help in taking your first steps!

Below is a "diff" showing in red (and a -) which lines to remove, and in green (and a +) which lines to add:

$DIFF
  • 💾 Commit your changes

  • 🔀 Start a Pull Request. There are two ways how you can start a pull request:

  1. If you are familiar with the terminal or would like to learn it, here is a great tutorial on how to send a pull request using the terminal.

  2. You can also edit files directly in your browser and open a pull request from there.

  • 🏁 Done Ask in comments for a review :)

Please keep us updated

💬 - We encourage contributors to be respectful to the community and provide an update within a week of claiming a first-timers-only issue. We're happy to keep it assigned to you as long as you need if you update us with a request for more time or help, but if we don't see any activity a week after you claim it we may reassign it to give someone else a chance. Thank you in advance!

If this happens to you, don't sweat it! Grab another open issue.

Is someone else already working on this?

🔗- We encourage contributors to link to the original issue in their pull request so all users can easily see if someone's already started on it.

👥- If someone seems stuck, offer them some help! Otherwise, take a look at some other issues you can help with. Thanks!

🤔 Questions?

Leave a comment below!

Relevant URLs

http://mapknitter-stable.laboratoriopublico.org/maps/test

The page to be changed is https://github.com/publiclab/mapknitter/blob/main/app/views/maps/show.html.erb

@cesswairimu

This comment has been minimized.

Copy link
Collaborator Author

commented Oct 7, 2019

@fadib here is an issue for you

@fadib

This comment has been minimized.

Copy link

commented Oct 7, 2019

Thanks! I will submit a PR soon. Looking forward to contributing more

@fadib fadib referenced a pull request that will close this issue Oct 7, 2019
3 of 3 tasks complete
@parthpanchal123 parthpanchal123 referenced a pull request that will close this issue Oct 8, 2019
@briannadeg

This comment has been minimized.

Copy link

commented Oct 8, 2019

I would like to contribute!

@ishitar

This comment has been minimized.

Copy link

commented Oct 9, 2019

Can I contribute?

@fadib

This comment has been minimized.

Copy link

commented Oct 9, 2019

@briannadeg and @ishitar: add your name here #6206

@FrozenGirl-spd

This comment has been minimized.

Copy link

commented Oct 10, 2019

holla

anushtha1011 added a commit to anushtha1011/mapknitter that referenced this issue Oct 12, 2019
Added a line and  a piece of code at the end of file
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
5 participants
You can’t perform that action at this time.