library and code repository

classic Classic list List threaded Threaded
27 messages Options
12
Reply | Threaded
Open this post in threaded view
|

library and code repository

jon_bondy
I just bumped into a guy who might be a prime candidate for OS, but he
needs gently curved, graceful shapes.  I fear that he will wander off
quickly if I cannot show him Bezier libraries and the like.  I see LOTS
of creative stuff on this forum, but often loose track of where I heard
of something.

Do we have a single repository for all things OS?  The actual code need
not live there, so long as links to the actual code are present. I would
like to be able to quickly respond to his needs so that he joins us.

Jon


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

MichaelAtOz
Administrator
It's not well maintained but there is the list at the bottom of this manual page.
Historically much code has been listed as Things on Thingiverse, but the prusa dummy spit seems to have diversified that.
Admin - email* me if you need anything,
or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

Unless specifically shown otherwise above, my contribution is in the Public Domain; to the extent possible under law, I have waived all copyright and related or neighbouring rights to this work.
Obviously inclusion of works of previous authors is not included in the above.


The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/ time is running out!
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

jon_bondy
Perhaps we can encourage everyone on this list to provide a copy of
their work on this list, either directly, or as links to (say)
Thingiverse items.  One stop shopping.  Same thing for useful code
fragments.

Jon


On 9/10/2016 7:32 PM, MichaelAtOz wrote:

> It's not well maintained but there is the list at the bottom of  this manual
> page <https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries>  .
> Historically much code has been listed as Things on Thingiverse, but the
> prusa dummy spit seems to have diversified that.
>
>
>
> -----
> Admin - PM me if you need anything, or if I've done something stupid...
>
> Unless specifically shown otherwise above, my contribution is in the Public Domain; to the extent possible under law, I have waived all copyright and related or neighbouring rights to this work. Obviously inclusion of works of previous authors is not included in the above.
>
> The TPP is no simple “trade agreement.”   Fight it! http://www.ourfairdeal.org/   time is running out!
> --
> View this message in context: http://forum.openscad.org/library-and-code-repository-tp18354p18361.html
> Sent from the OpenSCAD mailing list archive at Nabble.com.
>
> _______________________________________________
> OpenSCAD mailing list
> [hidden email]
> http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
>
>
> -----
> No virus found in this message.
> Checked by AVG - www.avg.com
> Version: 2016.0.7752 / Virus Database: 4649/12986 - Release Date: 09/10/16


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

Neon22
Or an 'offical' github account that could then fork (and thereby
reference) all the useful libs.
- so anyone going to that top level "openscad group" account can see all
the repositories that contain useful code
- a group of people who belong to that group determine which libs are
forked. (and thereby judge which is currently "useful" to the released
version of openSCAD.
- I woudl suggest the group did no pwork or create pull requests themselves.

Many similar examples on github currrently.
People are also discussing GitLab instead of Github but I don't have
enough info to suggest which is "better"


On 9/12/2016 2:46 AM, jon wrote:

> Perhaps we can encourage everyone on this list to provide a copy of
> their work on this list, either directly, or as links to (say)
> Thingiverse items.  One stop shopping.  Same thing for useful code
> fragments.
>
> Jon
>
>
> On 9/10/2016 7:32 PM, MichaelAtOz wrote:
>> It's not well maintained but there is the list at the bottom of  this
>> manual
>> page <https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries> .
>> Historically much code has been listed as Things on Thingiverse, but the
>> prusa dummy spit seems to have diversified that.
>>
>>
>>
>> -----
>> Admin - PM me if you need anything, or if I've done something stupid...
>>
>> Unless specifically shown otherwise above, my contribution is in the
>> Public Domain; to the extent possible under law, I have waived all
>> copyright and related or neighbouring rights to this work. Obviously
>> inclusion of works of previous authors is not included in the above.
>>
>> The TPP is no simple “trade agreement.”   Fight it!
>> http://www.ourfairdeal.org/   time is running out!
>> --
>> View this message in context:
>> http://forum.openscad.org/library-and-code-repository-tp18354p18361.html
>> Sent from the OpenSCAD mailing list archive at Nabble.com.
>>
>> _______________________________________________
>> OpenSCAD mailing list
>> [hidden email]
>> http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
>>
>>
>> -----
>> No virus found in this message.
>> Checked by AVG - www.avg.com
>> Version: 2016.0.7752 / Virus Database: 4649/12986 - Release Date:
>> 09/10/16
>
>
> _______________________________________________
> OpenSCAD mailing list
> [hidden email]
> http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
>
>
> -----
> No virus found in this message.
> Checked by AVG - www.avg.com
> Version: 2016.0.7752 / Virus Database: 4649/12991 - Release Date:
> 09/11/16


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
I think the main thing is not the technical part, it's people
having the time and motivation to do that.

If that's there, the initial project could be just based on the
existing wiki page and then start to looking for better technical
solutions.

I still believe http://thingtracker.net/ would be a cool system
to have.

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

louijp
I agree with Torsten.
wiki pages could do the trick with a well organized FAQ with code examples.

Could be called OpenSCAD Tips and Tricks.

Jean-Paul
N1JPL

> On Sep 11, 2016, at 5:30 PM, Torsten Paul <[hidden email]> wrote:
>
> I think the main thing is not the technical part, it's people
> having the time and motivation to do that.
>
> If that's there, the initial project could be just based on the
> existing wiki page and then start to looking for better technical
> solutions.
>
> I still believe http://thingtracker.net/ would be a cool system
> to have.
>
> ciao,
>  Torsten.
>
>
> _______________________________________________
> OpenSCAD mailing list
> [hidden email]
> http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

runsun
In reply to this post by jon_bondy
jon_bondy wrote
Perhaps we can encourage everyone on this list to provide a copy of
their work on this list
Have been doing this with my signature.
$ Runsun Pan, PhD
$ libs: scadx, doctest, faces(git), offline doc(git), runscad.py(2,git), editor of choice: CudaText ( OpenSCAD lexer); $ Tips; $ Snippets
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

Richard Urwin
runsun wrote
jon_bondy wrote
Perhaps we can encourage everyone on this list to provide a copy of
their work on this list
Have been doing this with my signature.
Yeah, but it doesn't give me at least (an extreme newbie) the slightest idea what most of them do.

To my mind this sort of thing has to be wrapped in a write-up. The Design Pattern format is a good template:

    Pattern Name and Classification: A descriptive and unique name that helps in identifying and referring to the pattern.
    Intent: A description of the goal behind the pattern and the reason for using it.
    Also Known As: Other names for the pattern.
    Motivation (Forces): A scenario consisting of a problem and a context in which this pattern can be used.
    Applicability: Situations in which this pattern is usable; the context for the pattern.
    Structure: A graphical representation of the pattern. Class diagrams and Interaction diagrams may be used for this purpose.
    Consequences: A description of the results, side effects, and trade offs caused by using the pattern.
    Implementation: A description of an implementation of the pattern; the solution part of the pattern.
    Sample Code: An illustration of how the pattern can be used in a programming language.
    Known Uses: Examples of real usages of the pattern.
    Related Patterns: Other patterns that have some relationship with the pattern; discussion of the differences between the pattern and similar patterns.

For example:

https://www.gov.uk/service-manual/user-centred-design/resources/patterns/names.html


Also, if this doesn't get into the OpenSCAD Wiki, then wikidot.com would be a good home for it. It's free to set up a new site (some subtle advertising) and it allows powerful site design using only the wiki syntax. Also sections of code quoted in a post have their own direct link, making downloading the code very easy. The only thing it doesn't do as well as git is version control.
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

Ronaldo
In reply to this post by tp3
I also agree with Torsten about a code repository. We would need a voluntary to do or, at least, start the hard job.

However, I think that a chapter in the OpenSCAD Manual could comply with the demand for Tips and Tricks without much effort. It could have a basic, medium and advanced sections. The basic section should be recommended for all beginners in other parts of the Manual. I would contribute on that if such chapter is created and I believe many of the advanced users would do the same.
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

runsun
In reply to this post by Richard Urwin
Richard Urwin wrote
Yeah, but it doesn't give me at least (an extreme newbie) the slightest idea what most of them do.

To my mind this sort of thing has to be wrapped in a write-up.
Well, life is not perfect :(  At least, I've started it long time ago.
$ Runsun Pan, PhD
$ libs: scadx, doctest, faces(git), offline doc(git), runscad.py(2,git), editor of choice: CudaText ( OpenSCAD lexer); $ Tips; $ Snippets
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
In reply to this post by Ronaldo
On 09/15/2016 09:32 PM, Ronaldo wrote:
> I also agree with Torsten about a code repository. We would need
> a voluntary to do or, at least, start the hard job.
>
I guess it's probably 2 separate things...

> However, I think that a chapter in the OpenSCAD Manual could comply
> with the demand for Tips and Tricks without much effort. It could
> have a basic, medium and advanced sections. The basic section should
> be recommended for all beginners in other parts of the Manual. I
> would contribute on that if such chapter is created and I believe
> many of the advanced users would do the same.
>
... "Tips and Tricks" page as part of the manual, having snippets that
are maybe a couple of lines long.

Page created now, feel free to add more snippets :-)

=> https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Tips_and_Tricks

Libraries and bigger code collections are likely a different thing,
we could start just pointing to various places with some added info
of how to use it, like Thingiverse, github, blog posts for now. If it
actually gets going, it might be possible to have some additional
technical support using some database backed web site.

But as said before, I think it makes sense getting some base
collection first before starting to create a huge effort for a site
that might never be used. But who knows, that might even be a topic
for a future GSoC project if we get the chance to participate again.

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
On 09/17/2016 09:46 PM, Torsten Paul wrote:
> I guess it's probably 2 separate things...
>
Ah, there's another topic that probably separates the two...

I think all the small code snippets should be usable without
even thinking about attribution or other responsibilities that
come with various licenses. This is obviously not something
we want to have for bigger contributions or libraries.

It always bothered me that most books with code samples don't
even mention what the license is. So you look at the code and
can't even know if it's ok to use that code in your application.
That is stupid, let's not do that.
We already relicensed all the examples to CC0 to make things
easy. (Thanks again to everybody who made that possible).

I think any "official" standard library (in case that ever
happens... not talking about MCAD) should also come with a
very liberal license like MIT, BSD or CC0.

For other libraries, well, it's totally up to the people writing
those of cause :-).

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

MichaelAtOz
Administrator
tp3 wrote
On 09/17/2016 09:46 PM, Torsten Paul wrote:
> I guess it's probably 2 separate things...
>
Ah, there's another topic that probably separates the two...

I think all the small code snippets should be usable without
even thinking about attribution or other responsibilities that
come with various licenses. This is obviously not something
we want to have for bigger contributions or libraries.

It always bothered me that most books with code samples don't
even mention what the license is. So you look at the code and
can't even know if it's ok to use that code in your application.
That is stupid, let's not do that.
We already relicensed all the examples to CC0 to make things
easy. (Thanks again to everybody who made that possible).

I think any "official" standard library (in case that ever
happens... not talking about MCAD) should also come with a
very liberal license like MIT, BSD or CC0.

For other libraries, well, it's totally up to the people writing
those of cause :-).

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
I support the direction, but it seems at face value to be incompatible with wikibooks licence. Don't mean to be a PITA.
Admin - email* me if you need anything,
or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

Unless specifically shown otherwise above, my contribution is in the Public Domain; to the extent possible under law, I have waived all copyright and related or neighbouring rights to this work.
Obviously inclusion of works of previous authors is not included in the above.


The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/ time is running out!
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
On 09/18/2016 02:23 AM, MichaelAtOz wrote:
> I support the direction, but it seems at face value to be
> incompatible with wikibooks licence
> <https://en.wikibooks.org/wiki/Wikibooks:Copyrights>  .
> Don't mean to be a PITA.
>
Yeah, I was looking around trying to find what's possible
and found:

https://wikimediafoundation.org/wiki/Terms_of_Use

> Public domain content: Content that is in the public domain
> is welcome! It is important however that you confirm the
> public domain status of the content under the law of the
> United States of America as well as the laws of any other
> countries as required by the specific Project edition. When
> you contribute content that is in the public domain, you
> warrant that the material is actually in the public domain,
> and you agree to label it appropriately.

So I hope it's ok. CC0 is just the international version of
public domain as not everybody shares US law.

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

MichaelAtOz
Administrator
> When you contribute content that is in the public domain,
> you warrant that the material is actually in the public domain,
> and you agree to label it appropriately.

Seems to be the technical issue.

Given ATM a <source>...</source> 'extension' [I think teats what it's called, eg see, still looking for 'source'] is used, it may be possible to customise or make a derivative, which labels each with a footnote or such.

Any wiki guru's out there?
Admin - email* me if you need anything,
or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

Unless specifically shown otherwise above, my contribution is in the Public Domain; to the extent possible under law, I have waived all copyright and related or neighbouring rights to this work.
Obviously inclusion of works of previous authors is not included in the above.


The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/ time is running out!
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

MichaelAtOz
Administrator
https://www.mediawiki.org/wiki/Help:Contents seems to do PD.
Admin - email* me if you need anything,
or if I've done something stupid...
* click on my MichaelAtOz label, there is a link to email me.

Unless specifically shown otherwise above, my contribution is in the Public Domain; to the extent possible under law, I have waived all copyright and related or neighbouring rights to this work.
Obviously inclusion of works of previous authors is not included in the above.


The TPP is no simple “trade agreement.” Fight it! http://www.ourfairdeal.org/ time is running out!
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

Ronaldo
In reply to this post by tp3
tp3 wrote
Page created now, feel free to add more snippets :-)
Thank you, Torsten, for the page creation and for adding an image to the line drawing topic I inserted in it. I tried to insert an image but was not successful. Would you give me a link to a help on how to do it?
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
On 09/19/2016 05:28 PM, Ronaldo wrote:
> tp3 wrote
>> Page created now, feel free to add more snippets :-)
>
> Thank you, Torsten, for the page creation and for adding an
> image to the line drawing topic I inserted in it. I tried to
> insert an image but was not successful. Would you give me a
> link to a help on how to do it?
>
What I'm doing is:

1) Upload the image to Wikimedia Commons via the "Upload file"
   link in the left tools menu (for the tips&tricks page I've
   used 1024x1024 exported images)
2) Set the image with CC0 (wasn't very complicated to create :-)
   and tag with "OpenSCAD" + "Screenshots"
3) Insert the link (shown right after the upload) into the page
   as Thumbnail (with added 200x for preview size) right above
   the <source> code section, e.g.

   [[File:Openscad-tips-knot.png|thumb|200px|OpenSCAD - Knot]]

ciao,
  Torsten.


_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
tp3
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

tp3
In reply to this post by Ronaldo
Ahh, I love the add2() solution. Very nice...

> function add2(v) = [for(p=v) 1]*v;

ciao,
  Torsten.

_______________________________________________
OpenSCAD mailing list
[hidden email]
http://lists.openscad.org/mailman/listinfo/discuss_lists.openscad.org
-- Torsten
Reply | Threaded
Open this post in threaded view
|

Re: library and code repository

Ronaldo
Well, I am tempted to include one more version:
function add4(v) = add(v, i = 0, r = 0*v);
which has the same generality of add3 with a simpler code.
It will be Trick I have used more then once but possibly away of the intention of that chapter.
In fact, I see this more as a principle (a vector space one) than a trick.
12