In kotlin and java you create an infinite sequence and then take the number of requested iterations. Then you use that when reducing.
The canonical problem sets pretty much all define black box behavior. “This input produces that output.” Very few exercises mandate specific approaches (map, fold). Some exercises suggest specific approaches, but rarely do tracks do any enforcement.
Are you proposing a problem where map/reduce is somehow actually enforced? Or is this a “calculate Pi” exercise with a suggestion that students consider using a specific approach? Or are those the same thing?
I guess it could be a suggestion though it looks like the natural strategy in my eyes
So I started sketching on a problem specification but I wonder how I should specify the expected value from each test, since it expects a decimal number within an interval, so for example with ten iteration, the solution should be π +/- 0.1, and for a hundred iterations it should be π +/- 0.01.
So should I write: “expected”: “π +/- 0.01”?
Or maybe simply the expected distance:
Then what should the property be? “distance”?
Hello. Thanks for opening a PR on Exercism. We are currently in a phase of our journey where we have paused community contributions to allow us to take a breather and redesign our community model. You can learn more in this blog post. As such, all issues and PRs in this repository are being automatically closed.
Didn’t realize that :(
That’s not to say we don’t take contributions at all for problem-specifications though! We do encourage discussion first here on the forum. Maybe others could chip in too?
To soft-enforce use of Leibniz’s approximation, you can check that the estimates fall within certain envelopes: for any given number of used terms the error is guaranteed to be less than some upper bound and greater than some lower bound.
My opinion on the matter: The PR includes the implementation as a requirement. Once again, I think the requirement should reflect the required input and output, and should not include the implementation. I think the implementation can be a strong recommendation but, unless you can somehow enforce it via tests, should not be listed as a requirement. The exercise should be “Compute Pi” and the prose can suggest using a specific approach for doing so.
I’m curious to hear what other maintainers think about this.
You can find the PR here in case you’re interested
I have three general top-of-the-head thoughts:
- If the hope is that a student completes it in a certain way in a certain track, details of that implementation can be added to that track’s “append” file. I think that’s more appropriate than in the PS version.
- Demonstrating a specific implementation is a perfect thing to create an Approach for and put on the Dig Deeper tab.
- If the decision was to have extra tests for a specific implementation, these should definitely be a
scenario(paired with the append above). But I’m generally uncomfortable with this as a thing, because I’d rather allow a student try and solve it one way and then compare that to the map/reduce method and understand why map/reduce is a thing.
So I’d encourage a track-specific append (with a hint to try map/reduce as one interesting method) and an Approach (and maybe accompanying video on map/reduce approach!) as the way to resolve this.
We’re in the process of overhauling all the problem specifications. (For context see [New Project] Making Practice Exercises more consistent and human across Exercism)
One of the things we are trying to do for each exercise is to provide a story to help frame the exercise and make it more concrete, approachable, and interesting. Not a great work of fiction, just a bit of context.
As an example, the pretext for pangram is that a company that sells fonts is running a competition to create pangrams that they can use to demonstrate the fonts on their site. The pretext for word count is that an English as a Second Language teacher is doing frequency analysis on subtitles from TV shows so that they can base their curriculum on gradually more challenging shows.
The mathy exercises have been much more challenging to work out decent stories for, and I really don’t want to have to reverse engineer something after the fact.
As such I would like to see some suggestions for stories/pretext before deciding whether or not to add this exercise.
Maybe I can borrow something from Liu Cixin’s “To Hold Up The Sky”:
A breed of aliens is in the process of destroying stars to isolate an enemy. While deciding if a star should be destroyed or not, they look for intelligent life forms in the star’s system. If such is found, and the species are intelligent enough, they might reconsider leaving the star intact. To evaluate their intelligence, one of the tests they give those life forms is whether they can calculate Pi to an adequate number of decimals. The aliens have now approached you and it is up to you to save the world! If you fail, the consequences are devastating.
Suddenly, you remember Leibniz formula for Pi, an easy way to calculate Pi to a certain degree of precision. Now go write a function using that formula and remember: the future of the world depends on your success!
Math-y and algorithm-y stories are tricky. (I’ll readily admit that I don’t love any of the ones I’ve come up with so far).
The word “story” might be the problem here. What we’re really aiming for is a wee bit of colorful context that helps make the exercise concrete.
For an example of where I was struggling and @dreig came to the rescue, see this thread: Need help reworking the saddle-points exercise introduction/instructions
Here, the story about the park with trees of different heights and a trade-off that is reasonable to imagine hits the perfect amount of story, to my mind.
Can you think of a more down-to-earth story for this particular approximation of Pi?
My gut sense is that if we don’t have a story that hits the right note, I’d prefer to not add it as an exercise.
Also note Jeremy’s note about not making the specific implementation part of the requirement.
Yeah, I agree, it’s hard to find a down-to-earth-y excuse for having to calculate Pi to the nth decimal. We can skip that exercise if that is required.
It’s not a hard requirement per se, but rather a… sort of firm and getting firmer requirement. (The more I wrestle with reverse engineering stories, the firmer this requirement seems to get).
It’s very likely that we’ll deprecate some of the existing exercises later, if we can’t get a decent story for them.
My sense is that if we can find a down to earth (-ish) story here, then we can consider it, but without it I would prefer not to.
How about calculating Pi using a different approach? Like the one below
To save on frustration, perhaps consider immediately asking about math exercies on the forum?
Yeah, that’s going to be my new strategy :-)