Metadata-Version: 1.1
Name: ck
Version: 1.6.15
Summary: Collective Knowledge - lightweight knowledge manager to organize, cross-link, share and reuse artifacts
Home-page: https://github.com/ctuning/ck/wiki
Author: Grigori Fursin and non-profit cTuning foundation
Author-email: Grigori.Fursin@cTuning.org
License: BSD 3-clause
Description: Introduction
        ============
        
        Collective Knowledge is our "swiss knife" for open, collaborative and reproducible experimentation.
        CK is a small, portable and customizable research platform to
        * share artifacts as reusable and indexable Python components with unified JSON API and meta information (programs, benchmarks, data sets, tools, predictive models, etc); 
        * quickly prototype experimental workflows from shared components (such as customizable and multi-objective autotuning for DSL, OpenCL, CUDA, MPI, OpenMP and compiler flags);
        * crowdsource experiments across diverse hardware and workloads provided by volunteers, and report "interesting" or unexpected behavior;
        * unify and abstract access to continuously evolving software across Windows, Linux and Android (tools, programs, libraries);
        * use the latest environment for experiments (rather than using quickly outdated virtual images);
        * automate, reproduce and crowdsource empirical experiments (using CK JSON-based web services);
        * unify access to predictive analytics via unified JSON API and CK web services (scikit-learn, R, DNN, etc);
        * enable reproducible and interactive articles. 
        
        Project homepage: 
        * http://cknowledge.org
        * http://cTuning.org
        
        License
        =======
        * Permissive 3-clause BSD license (see LICENSE.txt file for more details).
        
        Minimal installation
        ====================
        
        The minimal installation requires:
        
        * Python >= 2.6 (3.0+ is natively supported) - we suggest Anaconda scientific Python distribution;
        * Git command line client.
        
        On Ubuntu, you can install these dependencies via
        
        $ apt-get install python git
        
        On Windows, you can download and install these tools from the following sites:
        
        * Git: https://git-for-windows.github.io
        * Minimal Python: https://www.python.org/downloads/windows
        * Anaconda scientific Python with all packages: https://www.continuum.io/downloads#_windows
        
        For example, you can install shared workflow for collaborative program optimization
        with all related artifacts, and start participating in multi-objective crowdtuning 
        simply as following: 
        
         $ git clone https://github.com/ctuning/ck.git ck
        
         $ export PATH=$PWD/ck/bin:$PATH (on Linux)
        or
         $ set PATH={CURRENT PATH}\ck\bin;%PATH% (on Windows)
        
         $ ck pull repo:ck-crowdtuning
        
         $ ck crowdsource experiment (to crowdsource any available experiment scenario on Linux)
        or
         $ ck crowdtune program --gcc --target_os=mingw-64 (to crowdsource program optimization on Windows via GCC MingW compiler)
        
        If you have GCC or LLVM compilers installed, you can start continuously crowd-tune 
        their optimization heuristics in a quiet mode (for example overnight) via
        
        $ ck crowdtune program --llvm --quiet
        
        $ ck crowdtune program --gcc --quiet
        
        This experimental workflow will be optimizing different shared workloads
        for multiple objectives (execution time, code size, energy, compilation time, etc)
        using all exposed design and optimization knobs, while sending best performing 
        optimizations to the public CK-based server:
        
        * http://cTuning.org/crowd-results
        * http://cknowledge.org/interactive-report
        
        CK server will, in turn, perform on-line learning to classify optimization 
        versus workloads which can be useful for compiler/hardware designers and 
        performance engineers (described in more detail in http://arxiv.org/abs/1506.06256 ).
        
        You can even participate in collaborative experiments using your Android mobile phone
        by installing the following application from the Google Play Store:
        
        * https://play.google.com/store/apps/details?id=openscience.crowdsource.experiments
        
        You can find already shared artifacts and repositories here:
        * List of shared repositories: https://github.com/ctuning/ck/wiki/Shared_repos
        * List of shared modules: https://github.com/ctuning/ck/wiki/Shared_modules
        
        Please check out CK getting started guide and CK wiki for further details:
        * https://github.com/ctuning/ck/wiki/Getting_started_guide_basic
        * https://github.com/ctuning/ck/wiki
        
        Related initiatives
        ===================
        
        * Artifact Evaluation for computer systems' conferences: http://cTuning.org/ae
        * New publication model with the community-driven public reviewing: http://adapt-workshop.org
        
        * http://arxiv.org/abs/1506.06256
        * http://bit.ly/ck-date16
        * http://hal.inria.fr/hal-01054763
        
        CK-powered projects
        ===================
        * https://github.com/ctuning/ck/wiki/Summary_of_projects
        
        Motivation
        ==========
        * https://github.com/ctuning/ck/wiki/Motivation
        
        Authors
        =======
        * Grigori Fursin, http://fursin.net
        * Anton Lokhmotov, https://www.hipeac.net/~anton
        
        Questions/comments/discussions?
        ===============================
        Please, use our mailing lists:
        * Open, collaborative and reproducible R&D including knowledge preservation, sharing and reuse:
          http://groups.google.com/group/collective-knowledge
        * Software and hardware multi-objective (performance/energy/accuracy/size/reliability/cost)
          benchmarking, autotuning, crowdtuning and run-time adaptation: http://groups.google.com/group/ctuning-discussions
        
        Publications
        ============
        Concepts has been described in the following publications:
        
        * http://arxiv.org/abs/1506.06256 (CPC'15)
        * http://bit.ly/ck-date16 (DATE'16)
        * http://cknowledge.org/interactive-report
        * http://hal.inria.fr/hal-01054763 (Journal of Scientific Programming'14)
        * http://arxiv.org/abs/1406.4020 (TRUST'14 @ PLDI'14)
        * https://hal.inria.fr/inria-00436029 (GCC Summit'09)
        
        If you found CK useful and/or interesting, you are welcome
        to reference any of the above publications in your articles
        and reports. You can download above references in BibTex 
        format here:
        
        * https://raw.githubusercontent.com/ctuning/ck-guide-images/master/collective-knowledge-refs.bib
        
        Testimonials and awards
        =======================
        * ARM and dividiti are using CK to accelerate computer engineering (2016, https://www.hipeac.net/assets/public/publications/newsletter/hipeacinfo45.pdf , page 17)
        * HiPEAC technology transfer award (2015, http://www.hipeac.net)
        
        Acknowledgments
        ===============
        
        CK development is coordinated by the non-profit cTuning foundation
        (cTuning.org). We would like to thank the EU TETRACOM 609491 project
        (www.tetracom.eu) for initial funding and dividiti (www.dividiti.com)
        for continuing support. We are also extremely grateful to all volunteers
        for their valuable feedback and contributions.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Plugins
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: System
Classifier: Topic :: System :: Benchmark
Classifier: Topic :: Education
Classifier: Topic :: Home Automation
Classifier: Topic :: Adaptive Technologies
Classifier: Topic :: Database
Classifier: Topic :: Utilities
