Commit 1a1d60b0 authored by Georges Khaznadar's avatar Georges Khaznadar

deleted generated files

parent 1ce848dc
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Introduction &#8212; eyes17 1.0 documentation</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="The equipment" href="1.2.html" />
<link rel="prev" title="Getting Started" href="index.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="1.2.html" title="The equipment"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Getting Started"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Getting Started</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="1.2.html"
title="next chapter">The equipment</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/1.1.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="introduction">
<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline"></a></h1>
<p>Science is the study of the physical world by systematic observations
and experiments. Proper science education is essential for cultivating a
society where reasoning and logical thinking prevails and not
superstition and irrational beliefs. Science education is also essential
for training enough technicians, engineers and scientists for the
economy of the modern world. It is widely accepted that personal
experience in the form of experiments and observations, either carried
out by students or performed as demonstrations by teachers, are
essential to the pedagogy of science. However, almost everywhere science
is mostly taught from the text books without giving importance to
experiments, partly due to lack of equipment. As a result, most of the
students fail to correlate their classroom experience to problems
encountered in daily life. To some extent this can be corrected by
learning science based on exploration and experimenting.</p>
<p>The advent of personal computers and their easy availability has opened
up a new path for making laboratory equipment. Addition of some hardware
to an ordinary computer can convert it in to a science laboratory.
Performing quick measurements with good accuracy enables one to study a
wide range of phenomena. Science experiments generally involve
measuring/controlling physical parameters like temperature, pressure,
velocity, acceleration, force, voltage, current etc. If the measured
physical property is changing rapidly, the measurements need to be
automated and a computer becomes a useful tool. For example,
understanding the variation of AC mains voltage with time requires
measuring it after every millisecond.</p>
<p>The ability to perform experiments with reasonable accuracy also opens
up the possibility of research oriented science education. Students can
compare the experimental data with mathematical models and examine the
fundamental laws governing various phenomena. Research scientists do the
same with highly sophisticated equipment. The expEYES ( expEriments for
Young Engineers &amp; Scientists) kit is designed to support a wide range of
experiments, from school to post graduate level. It also acts as a test
equipment for electronics engineers and hobbyists. The simple and open
architecture of expEYES allows the users to <em>develop new experiments,
without getting into the details of electronics or computer
programming</em>. This User’s manual describes <em>expEYES-17</em> along with
several experiments, there is also a Programmer’s manual available.</p>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="1.2.html" title="The equipment"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Getting Started"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2018, Jithin B.P..
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.7.5.
</div>
</body>
</html>
\ No newline at end of file
This diff is collapsed.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Software Installation &#8212; eyes17 1.0 documentation</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="The main GUI program" href="1.4.html" />
<link rel="prev" title="The equipment" href="1.2.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="1.4.html" title="The main GUI program"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="1.2.html" title="The equipment"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Software Installation</a><ul>
<li><a class="reference internal" href="#any-gnu-linux-distributions">Any GNU/Linux distributions</a></li>
<li><a class="reference internal" href="#debian-or-ubuntu-gnu-linux-distributions">Debian or Ubuntu GNU/Linux distributions</a></li>
<li><a class="reference internal" href="#the-expeyes-live-cd-usb-pendrive">The expEYES Live CD / USB pendrive</a></li>
<li><a class="reference internal" href="#on-mswindows">On MSWindows</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="1.2.html"
title="previous chapter">The equipment</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="1.4.html"
title="next chapter">The main GUI program</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/1.3.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="software-installation">
<h1>Software Installation<a class="headerlink" href="#software-installation" title="Permalink to this headline"></a></h1>
<p>ExpEYES can run on any computer having a Python Interpreter and required
modules. The USB interface is handled by a device driver program that
presents the USB port as a Serial port to the Python programs. The
communication the expEYES is done using a library written in Python.
Programs with GUI have been written for many experiments. Eyes17
software require the following packages</p>
<ul class="simple">
<li>python-serial</li>
<li>python-numpy</li>
<li>python-scipy</li>
<li>python-qt4</li>
<li>python-pyqtgraph</li>
</ul>
<div class="section" id="any-gnu-linux-distributions">
<h2>Any GNU/Linux distributions<a class="headerlink" href="#any-gnu-linux-distributions" title="Permalink to this headline"></a></h2>
<p>Download <strong>eyes17-x.x.x.zip</strong> (the latest version) from
<strong>http://expeyes.in</strong> and upzip it, and change to the newly created
folder. Issue the command</p>
<blockquote>
<div><p>$ sudo sh postinst # set user write permission</p>
<p>$ python main.py</p>
</div></blockquote>
<p>You will get error messages for any missing packages that are required
for expeyes. Install them one by one and try again. Python programs
required for several experiments are in the same directory, they are
called by ’main.py’.</p>
</div>
<div class="section" id="debian-or-ubuntu-gnu-linux-distributions">
<h2>Debian or Ubuntu GNU/Linux distributions<a class="headerlink" href="#debian-or-ubuntu-gnu-linux-distributions" title="Permalink to this headline"></a></h2>
<p>Download <strong>eyes17-x.x.x.deb</strong> ( the latest version) from the software
section of <strong>http://expeyes.in</strong> and install it using the command;</p>
<blockquote>
<div>$ sudo gdebi eyes17-x.x.x.deb</div></blockquote>
<p>while connected to Internet</p>
<p>The package ’eyes17’ (later than version 3) does not depend on the
earlier versions of ExpEYES, like expeyes junior. During installation
gdebi will automatically dowload and install all the required packages.</p>
</div>
<div class="section" id="the-expeyes-live-cd-usb-pendrive">
<h2>The expEYES Live CD / USB pendrive<a class="headerlink" href="#the-expeyes-live-cd-usb-pendrive" title="Permalink to this headline"></a></h2>
<p>The ISO image containing support for eyes17 can be downloaded from HERE.
Make a DVD or USB memory stick bootable using this ISO image (Download
rufus from <a class="reference external" href="https://rufus.akeo.ie">https://rufus.akeo.ie</a> to do this under MSWindows)</p>
<p>Switch off the PC and insert the liveCD/Pendrive and switch it on. Enter
the BIOS while booting, make the CDdrive/USB hard disk as the first boot
device. A desktop will appear and you can start expEYES-17 from the menu
<strong>Applications-&gt;Education</strong>-&gt;ExpEYES-17. You can also start it from a
Terminal using the command:</p>
<blockquote>
<div>$ python /usr/share/expeyes/eyes17/main.py</div></blockquote>
</div>
<div class="section" id="on-mswindows">
<h2>On MSWindows<a class="headerlink" href="#on-mswindows" title="Permalink to this headline"></a></h2>
<p>The first thing to do is to install the driver software for the USB to
serial converter IC MCP2200, available on Microchip website (also given
on expeyes website). After installing this the device will appear as a
COM port, that can be verified from the device manager of MSWindows.
After this there are two options.</p>
<p>A zip file containing all the necessary things for ExpEYES is available
on the website, named eyes17win.zip. Unzip this file and run main.py
from that. By using this method you will not able to write your own
Python code to access expeyes, for that you need to install the
following</p>
<ol class="arabic simple">
<li>Python-2.x version</li>
<li>python-serial</li>
<li>python-qt4</li>
<li>python-pyqtgraph,</li>
<li>python-numpy</li>
<li>python-scipy</li>
</ol>
<p>Download the eyes17-x.x.x.zip ( take latest version) from the website.
Unzipping the files will create a directory <strong>named eyes17</strong>, run
<strong>main.py</strong> from that.</p>
</div>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="1.4.html" title="The main GUI program"
>next</a> |</li>
<li class="right" >
<a href="1.2.html" title="The equipment"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2018, Jithin B.P..
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.7.5.
</div>
</body>
</html>
\ No newline at end of file
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>The main GUI program &#8212; eyes17 1.0 documentation</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Getting Familiar with ExpEYES17" href="1.5.html" />
<link rel="prev" title="Software Installation" href="1.3.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="1.5.html" title="Getting Familiar with ExpEYES17"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="1.3.html" title="Software Installation"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="1.3.html"
title="previous chapter">Software Installation</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="1.5.html"
title="next chapter">Getting Familiar with ExpEYES17</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/1.4.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="the-main-gui-program">
<h1>The main GUI program<a class="headerlink" href="#the-main-gui-program" title="Permalink to this headline"></a></h1>
<p>Start Applications-&gt;Education-&gt;ExpEYES-17 from the menu. A four channel
oscilloscope screen with several extra features will open as shown in
figure <a class="reference internal" href="#the-scope17-screen"><span class="std std-ref">The scope17 screen showing two traces</span></a>. Various experiments can be
selected from the menu.</p>
<div class="figure" id="id1">
<span id="the-scope17-screen"></span><img alt="_images/scope17.png" src="_images/scope17.png" />
<p class="caption"><span class="caption-text">The scope17 screen showing two traces</span></p>
</div>
<p>The main window looks like a low frequency four channel oscilloscope,
with some extra features, on the right side panel. Applications for
various experiments can be selected from the pulldown menu. A brief
description of the oscilloscope program is given below.</p>
<ul class="simple">
<li>Any of the four inputs (A1, A2, A3 or MIC) can be enabled using the
corresponding checkbox. The input range can be selected by clicking
on the menubutton on the right side of the checkbox. Select the
desired input range from the popup menu.</li>
<li>There is another checkbox, to enable mathematical fitting of the data
using V = V0sin(2πft + θ) + C to show the amplitude and
frequency.</li>
<li>The horizontal scale (time base) can be changed by a slider, from .5
mS fullscale to 500 mS full scale.</li>
<li>The Checkbutton <strong>Freeze</strong>, allows to pause and resume the
oscilloscope operation.</li>
<li>The Trigger level can be set by a slider, and there is a menubutton
to select the trigger source.</li>
<li>To save the traces to a file, edit the filename and click on the
<strong>SaveTo</strong> button.</li>
<li>Clicking on <strong>FFT</strong> shows the frequency spectrum of all the eneabled
channels, appears on popup windows.</li>
</ul>
<p>In addition to the Oscilloscope, there are several measurement/control
options available on the GUI, they are explained below.</p>
<ul class="simple">
<li>If selected, the voltages at the inputs A1, A2 and A3 are sampled
every second and displayed.</li>
<li>The resistance connected between SEN and Ground is measured and
displayed every second.</li>
<li>Clicking <strong>Capacitance on IN1</strong>, measures the value of the capacitor
connected between IN1 and GND.</li>
<li>Clicking <strong>Frequency on IN2</strong>, measures the frequency of an external
digital (TTL standard) pulse connected to IN2</li>
<li>The shape of the waveform can be selected using the menubutton,
default shape is sine. It can be changed to triangular. When the
square wave option is selected, the output is shifted to SQ2. You
cannot have sine/triangular and SQ2 at the same time.</li>
<li>Frequency of the Waveform generator WG can be set using the slider or
the text entry window. The two input methods follow each other,
changing the slider will change the text field and entering data
using text field will set the slider to that value. The frequency
will be set to the nearest possible value and it will be displayed in
the message window at the bottom. The amplitude of WG output can be
set to 3 volts, 1 volt or 80 mV.</li>
<li>SQ1 can be set using the same method as explained above. The duty
cycle can be set between 1% to 99%, default is 50%.</li>
<li>The programmable volages PV1 and PV2 are also set in a similar
manner.</li>
<li>Checkbuttons are provided to control OD1 and CCS.</li>
</ul>
</div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="1.5.html" title="Getting Familiar with ExpEYES17"
>next</a> |</li>
<li class="right" >
<a href="1.3.html" title="Software Installation"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2018, Jithin B.P..
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.7.5.
</div>
</body>
</html>
\ No newline at end of file
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Getting Familiar with ExpEYES17 &#8212; eyes17 1.0 documentation</title>
<link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Measuring Voltage" href="2.1.html" />
<link rel="prev" title="The main GUI program" href="1.4.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="2.1.html" title="Measuring Voltage"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="1.4.html" title="The main GUI program"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">eyes17 1.0 documentation</a> &#187;</li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="1.4.html"
title="previous chapter">The main GUI program</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="2.1.html"
title="next chapter">Measuring Voltage</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/1.5.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />