diff --git a/.gitignore b/.gitignore index 68bfaecb..307523aa 100644 --- a/.gitignore +++ b/.gitignore @@ -26,3 +26,6 @@ doc/source/auto_examples/applications/ doc/source/_static/random.js .idea/ *.log +doc/release/_release_notes_for_docs.txt +doc/gh-pages +wheels diff --git a/TASKS.txt b/TASKS.txt index 0046b6a3..886826ea 100644 --- a/TASKS.txt +++ b/TASKS.txt @@ -11,7 +11,6 @@ How to contribute to ``skimage`` gitwash/index gsoc2011 - coverage_table cell_profiler diff --git a/doc/.gitignore b/doc/.gitignore deleted file mode 100644 index ec979e5a..00000000 --- a/doc/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -gh-pages -source/coverage_table.txt - diff --git a/doc/Makefile b/doc/Makefile index 093f65ea..82478f07 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -12,7 +12,7 @@ PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source DEST = build -.PHONY: all help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest gitwash gh-pages coveragetable random_gallery +.PHONY: all help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest gitwash gh-pages release_notes random_gallery all: html @@ -43,10 +43,11 @@ api: random_gallery: @cd source && $(PYTHON) random_gallery.py -coveragetable: - @cd source && $(PYTHON) coverage_generator.py +release_notes: + @echo "Copying release notes" + @tail -n +4 `ls release/*.txt | sort -k 2 -t . -n | tail -n 1` > release/_release_notes_for_docs.txt -html: api coveragetable random_gallery +html: api release_notes random_gallery $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(DEST)/html cp -r source/plots $(DEST)/html @echo diff --git a/doc/make.bat b/doc/make.bat deleted file mode 100644 index 5f117648..00000000 --- a/doc/make.bat +++ /dev/null @@ -1,129 +0,0 @@ -@ECHO OFF - -REM Command file for Sphinx documentation - -set SPHINXBUILD=sphinx-build -set ALLSPHINXOPTS=-d build/doctrees %SPHINXOPTS% source -if NOT "%PAPER%" == "" ( - set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS% -) - -if "%1" == "" goto help - -if "%1" == "help" ( - :help - echo.Please use `make ^` where ^ is one of - echo. html to make standalone HTML files - echo. dirhtml to make HTML files named index.html in directories - echo. pickle to make pickle files - echo. json to make JSON files - echo. htmlhelp to make HTML files and a HTML help project - echo. qthelp to make HTML files and a qthelp project - echo. devhelp to make HTML files and a Devhelp project - echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter - echo. changes to make an overview over all changed/added/deprecated items - echo. linkcheck to check all external links for integrity - echo. doctest to run all doctests embedded in the documentation if enabled - goto end -) - -for %%x in (html htmlhelp latex qthelp) do ( - if "%1" == "%%x" ( - md source\api 2>NUL - python tools/build_modref_templates.py - ) -) - - -if "%1" == "clean" ( - for /d %%i in (build\*) do rmdir /q /s %%i - del /q /s build\* - goto end -) - -if "%1" == "html" ( - cd source && python random_gallery.py && python coverage_generator.py && cd .. - %SPHINXBUILD% -b html %ALLSPHINXOPTS% build/html - echo. - echo.Build finished. The HTML pages are in build/html. - goto end -) - -if "%1" == "dirhtml" ( - %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% build/dirhtml - echo. - echo.Build finished. The HTML pages are in build/dirhtml. - goto end -) - -if "%1" == "pickle" ( - %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% build/pickle - echo. - echo.Build finished; now you can process the pickle files. - goto end -) - -if "%1" == "json" ( - %SPHINXBUILD% -b json %ALLSPHINXOPTS% build/json - echo. - echo.Build finished; now you can process the JSON files. - goto end -) - -if "%1" == "htmlhelp" ( - %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% build/htmlhelp - echo. - echo.Build finished; now you can run HTML Help Workshop with the ^ -.hhp project file in build/htmlhelp. - goto end -) - -if "%1" == "qthelp" ( - %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% build/qthelp - echo. - echo.Build finished; now you can run "qcollectiongenerator" with the ^ -.qhcp project file in build/qthelp, like this: - echo.^> qcollectiongenerator build\qthelp\scikitimage.qhcp - echo.To view the help file: - echo.^> assistant -collectionFile build\qthelp\scikitimage.ghc - goto end -) - -if "%1" == "devhelp" ( - %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% build/devhelp - echo. - echo.Build finished. - goto end -) - -if "%1" == "latex" ( - %SPHINXBUILD% -b latex %ALLSPHINXOPTS% build/latex - echo. - echo.Build finished; the LaTeX files are in build/latex. - goto end -) - -if "%1" == "changes" ( - %SPHINXBUILD% -b changes %ALLSPHINXOPTS% build/changes - echo. - echo.The overview file is in build/changes. - goto end -) - -if "%1" == "linkcheck" ( - %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% build/linkcheck - echo. - echo.Link check complete; look for any errors in the above output ^ -or in build/linkcheck/output.txt. - goto end -) - -if "%1" == "doctest" ( - %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% build/doctest - echo. - echo.Testing of doctests in the sources finished, look at the ^ -results in build/doctest/output.txt. - goto end -) - -:end diff --git a/doc/source/coverage.csv b/doc/source/coverage.csv deleted file mode 100644 index 02fb548f..00000000 --- a/doc/source/coverage.csv +++ /dev/null @@ -1 +0,0 @@ -Image Display and Exploration,Image Display and Exploration,Image File I/O,Image Types and Type Conversions GUI Tools,Modular Interactive Tools,Navigational Tools for Image Scroll Panel,Utilities for Interactive Tools Spatial Transformations and Image Registration,Spatial Transformations,Image Registration, Image Analysis and Statistics,Image Analysis,Texture Analysis,Pixel Values and Statistics Image Arithmetic,,, Image Enhancement and Restoration,Image Enhancement,Image Restoration (Deblurring), Linear Filtering and Transforms,Linear Filtering,Linear 2-D Filter Design,Image Transforms Morphological Operations,Intensity and Binary Images,Binary Images,Structuring Element Creation and Manipulation "ROI-Based, Neighborhood, and Block Processing",ROI-Based Processing,Neighborhood and Block Processing, Colormaps and Color Space,Color Space Conversions,, Utilities,Validation,Array Operations,Performance ,,, Make movie from multiframe image ,immovie ,:done:`immovie`,:partial:`immovie` "Play movies, videos, or image sequences ",implay ,:na:`n/a`, Display image ,imshow ,, Image Tool ,imtool ,, Display multiple image frames as rectangular montage,montage ,, Display multiple images in single figure ,subimage,, Display image as texture-mapped surface ,warp ,, , ,, Read metadata from header file of Analyze 7.5 data set ,analyze75info,, Read image data from image file of Analyze 7.5 data set ,analyze75read,, Anonymize DICOM file ,dicomanon ,, Get or set active DICOM data dictionary ,dicomdict ,, Read metadata from DICOM message ,dicominfo ,, Find attribute in DICOM data dictionary ,dicomlookup ,, Read DICOM image ,dicomread ,, Generate DICOM unique identifier ,dicomuid ,, Write images as DICOM files ,dicomwrite ,, Read high dynamic range (HDR) image ,hdrread ,, Write Radiance high dynamic range (HDR) image file ,hdrwrite ,, Read metadata from Interfile file ,interfileinfo,, Read images in Interfile format ,interfileread,, Check if file is R-Set ,isrset ,, Create high dynamic range image ,makehdr ,, Read metadata from National Imagery Transmission Format (NITF) file,nitfinfo ,, Read image from NITF file ,nitfread ,, Open R-Set file ,openrset ,, Create reduced resolution data set from image file ,rsetwrite ,, Render high dynamic range image for viewing ,tonemap ,, ,,, Convert Bayer pattern encoded image to truecolor image,demosaic,, Convert grayscale or binary image to indexed image,gray2ind,, Convert grayscale image to indexed image using multilevel thresholding,grayslice,, Global image threshold using Otsu's method,graythresh,, "Convert image to binary image, based on threshold",im2bw,, Convert image to double precision,im2double,, Convert image to 16-bit signed integers,im2int16,, Convert image to Java buffered image,im2java2d,, Convert image to single precision,im2single,, Convert image to 16-bit unsigned integers,im2uint16,, Convert image to 8-bit unsigned integers,im2uint8,, Convert indexed image to grayscale image,ind2gray,, Convert indexed image to RGB image,ind2rgb,, Convert label matrix into RGB image,label2rgb,, Convert matrix to grayscale image,mat2gray,, Convert RGB image or colormap to grayscale,rgb2gray,, ,,, Image Information tool,imageinfo,, Adjust Contrast tool,imcontrast,, Display Range tool,imdisplayrange,, Distance tool,imdistline,, Pixel Information tool,impixelinfo,, Pixel Information tool without text label,impixelinfoval,, Pixel Region tool,impixelregion,, Pixel Region tool panel,impixelregionpanel,, ,,, Magnification box for scroll panel,immagbox,, Overview tool for image displayed in scroll panel,imoverview,, Overview tool panel for image displayed in scroll panel,imoverviewpanel,, Scroll panel for interactive image navigation,imscrollpanel,, ,,, Convert axes coordinates to pixel coordinates,axes2pix,, Image data from axes,getimage,, Image model object from image object,getimagemodel,, Information about image attributes,imattributes,, Create draggable ellipse,imellipse,, Create draggable freehand region,imfreehand,, Get handle to current axes containing image,imgca,, Get handle to current figure containing image,imgcf,, Open Image dialog box,imgetfile,, Get all image handles,imhandles,, "Create draggable, resizable line",imline,, Create draggable point,impoint,, "Create draggable, resizable polygon",impoly,, Create draggable rectangle,imrect,, Region-of-interest (ROI) base class,imroi,, Add function handle to callback list,iptaddcallback,, Check validity of handle,iptcheckhandle,, Get Application Programmer Interface (API) for handle,iptgetapi,, Retrieve pointer behavior from HG object,iptGetPointerBehavior,, Directories containing IPT and MATLAB icons,ipticondir,, Create pointer manager in figure,iptPointerManager,, Delete function handle from callback list,iptremovecallback,, Store pointer behavior structure in Handle Graphics object,iptSetPointerBehavior,, Align figure windows,iptwindowalign,, Create rectangularly bounded drag constraint function,makeConstrainToRectFcn,, Adjust display size of image,truesize,, ,,, Create checkerboard image,checkerboard,, Find output bounds for spatial transformation,findbounds,, Flip input and output roles of TFORM structure,fliptform,, Crop image,imcrop,, Image pyramid reduction and expansion,impyramid,, Resize image,imresize,, Rotate image,imrotate,, Apply 2-D spatial transformation to image,imtransform,, Create resampling structure,makeresampler,, Create spatial transformation structure (TFORM),maketform,, Apply spatial transformation to N-D array,tformarray,, Apply forward spatial transformation,tformfwd,, Apply inverse spatial transformation,tforminv,, ,,, Infer spatial transformation from control point pairs,cp2tform,, Tune control-point locations using cross correlation,cpcorr,, Control Point Selection Tool,cpselect,, Convert CPSTRUCT to valid pairs of control points,cpstruct2pairs,, Normalized 2-D cross-correlation,normxcorr2,, ,,, Trace region boundaries in binary image,bwboundaries,, Trace object in binary image,bwtraceboundary,, Find corner points in image,corner,, Create corner metric matrix from image,cornermetric,, Find edges in grayscale image,edge,, Hough transform,hough,, Extract line segments based on Hough transform,houghlines,, Identify peaks in Hough transform,houghpeaks,, Quadtree decomposition,qtdecomp,, Block values in quadtree decomposition,qtgetblk,, Set block values in quadtree decomposition,qtsetblk,, ,,, Entropy of grayscale image,entropy,, Local entropy of grayscale image,entropyfilt,, Create gray-level co-occurrence matrix from image,graycomatrix,, Properties of gray-level co-occurrence matrix,graycoprops,, Local range of image,rangefilt,, Local standard deviation of image,stdfilt,, ,,, 2-D correlation coefficient,corr2,, Create contour plot of image data,imcontour,, Display histogram of image data,imhist,, Pixel color values,impixel,, Pixel-value cross-sections along line segments,improfile,, Average or mean of matrix elements,mean2,, Measure properties of image regions,regionprops,, Standard deviation of matrix elements,std2,, ,,, Absolute difference of two images,imabsdiff,, Add two images or add constant to image,imadd,, Complement image,imcomplement,, Divide one image into another or divide image by constant,imdivide,, Linear combination of images,imlincomb,, Multiply two images or multiply image by constant,immultiply,, Subtract one image from another or subtract constant from image,imsubtract,, ,,, Contrast-limited adaptive histogram equalization (CLAHE),adapthisteq,, Apply decorrelation stretch to multichannel image,decorrstretch,, Enhance contrast using histogram equalization,histeq,, Adjust image intensity values or colormap,imadjust,, Add noise to image,imnoise,, Convert integer values using lookup table,intlut,, 2-D median filtering,medfilt2,, 2-D order-statistic filtering,ordfilt2,, Find limits to contrast stretch image,stretchlim,, 2-D adaptive noise-removal filtering,wiener2,, ,,, Deblur image using blind deconvolution,deconvblind,, Deblur image using Lucy-Richardson method,deconvlucy,, Deblur image using regularized filter,deconvreg,, Deblur image using Wiener filter,deconvwnr,, Taper discontinuities along image edges,edgetaper,, Convert optical transfer function to point-spread function,otf2psf,, Convert point-spread function to optical transfer function,psf2otf,, ,,, 2-D convolution matrix,convmtx2,, Create predefined 2-D filter,fspecial,, N-D filtering of multidimensional images,imfilter,, ,,, 2-D frequency response,freqz2,, 2-D FIR filter using frequency sampling,fsamp2,, 2-D FIR filter using frequency transformation,ftrans2,, 2-D FIR filter using 1-D window method,fwind1,, 2-D FIR filter using 2-D window method,fwind2,, ,,, 2-D discrete cosine transform,dct2,, Discrete cosine transform matrix,dctmtx,, Convert fan-beam projections to parallel-beam,fan2para,, Fan-beam transform,fanbeam,, 2-D inverse discrete cosine transform,idct2,, Inverse fan-beam transform,ifanbeam,, Inverse Radon transform,iradon,, Convert parallel-beam projections to fan-beam,para2fan,, Create head phantom image,phantom,, Radon transform,radon,, ,,, Create connectivity array,conndef,, Bottom-hat filtering,imbothat,, Suppress light structures connected to image border,imclearborder,, Morphologically close image,imclose,, Dilate image,imdilate,, Erode image,imerode,, Extended-maxima transform,imextendedmax,, Extended-minima transform,imextendedmin,, Fill image regions and holes,imfill,, H-maxima transform,imhmax,, H-minima transform,imhmin,, Impose minima,imimposemin,, Morphologically open image,imopen,, Morphological reconstruction,imreconstruct,, Regional maxima,imregionalmax,, Regional minima,imregionalmin,, Top-hat filtering,imtophat,, Watershed transform,watershed,, ,,, Generate convex hull image from binary image,bwconvhull,, Neighborhood operations on binary images using lookup tables,applylut,, Area of objects in binary image,bwarea,, Morphologically open binary image (remove small objects),bwareaopen,, Find connected components in binary image,bwconncomp,, Distance transform of binary image,bwdist,, Euler number of binary image,bweuler,, Binary hit-miss operation,bwhitmiss,, Label connected components in 2-D binary image,bwlabel,, Label connected components in binary image,bwlabeln,, Morphological operations on binary images,bwmorph,, Pack binary image,bwpack,, Find perimeter of objects in binary image,bwperim,, Select objects in binary image,bwselect,, Ultimate erosion,bwulterode,, Unpack binary image,bwunpack,, Top-hat filtering,imtophat,, Create lookup table for use with ``applylut``,makelut,, ,,, Height of structuring element,getheight,, Structuring element neighbor locations and heights,getneighbors,, Structuring element neighborhood,getnhood,, Sequence of decomposed structuring elements,getsequence,, True for flat structuring element,isflat,, Reflect structuring element,reflect,, Create morphological structuring element (``STREL``),strel,, Translate structuring element (``STREL``),translate,, ,,, Convert region of interest (ROI) polygon to region mask,poly2mask,, Select region of interest (ROI) based on color,roicolor,, Fill in specified region of interest (ROI) polygon in grayscale image,roifill,, Filter region of interest (ROI) in image,roifilt2,, Specify polygonal region of interest (ROI),roipoly,, ,,, Determine optimal block size for block processing,bestblk,, Distinct block processing for image,blockproc,, Close ImageAdapter object,close (ImageAdapter),, Rearrange matrix columns into blocks,col2im,, Columnwise neighborhood operations,colfilt,, Rearrange image blocks into columns,im2col,, Interface for image I/O,ImageAdapter,, General sliding-neighborhood operations,nlfilter,, Read region of image,readRegion (ImageAdapter),, Write block of data to region of image,writeRegion (ImageAdapter),, ,,, Apply device-independent color space transformation,applycform,, Search for ICC profiles,iccfind,, Read ICC profile,iccread,, Find system default ICC profile repository,iccroot,, Write ICC color profile to disk file,iccwrite,, True for valid ICC color profile,isicc,, Convert L*a*b* data to double,lab2double,, Convert L*a*b* data to uint16,lab2uint16,, Convert L*a*b* data to uint8,lab2uint8,, Create color transformation structure,makecform,, Convert NTSC values to RGB color space,ntsc2rgb,, Convert RGB color values to NTSC color space,rgb2ntsc,, Convert RGB color values to YCbCr color space,rgb2ycbcr,, XYZ color values of standard illuminants,whitepoint,, Convert XYZ color values to double,xyz2double,, Convert XYZ color values to uint16,xyz2uint16,, Convert YCbCr color values to RGB color space,ycbcr2rgb,, ,,, Default display range of image based on its class,getrangefromclass,, Check validity of connectivity argument,iptcheckconn,, Check validity of array,iptcheckinput,, Check validity of colormap,iptcheckmap,, Check number of input arguments,iptchecknargin,, Check validity of option string,iptcheckstrs,, Convert positive integer to ordinal string,iptnum2ordinal,, ,,, Pad array,padarray,, ,,, Check for presence of Intel Integrated Performance Primitives (Intel IPP) library,ippl,, \ No newline at end of file diff --git a/doc/source/coverage_generator.py b/doc/source/coverage_generator.py deleted file mode 100755 index aa566acf..00000000 --- a/doc/source/coverage_generator.py +++ /dev/null @@ -1,276 +0,0 @@ -#!/usr/bin/env python - -from __future__ import division - -import sys -import os -import csv - -# Import StringIO module -try: - import cStringIO as StringIO -except ImportError: - try: - import StringIO - except: - import io as StringIO - -# Missing item value -MISSING_STRING=":missing:`Not Implemented`" - -def calculate_coverage(reader): - """Calculate portions of code that are in one of the coverage categories - - Returns a tuple representing the weighted items. The order is - - (done, partial, missing, not applicable) - - """ - # Coverage counters - total_items = 0 - partial_items = 0 - done_items = 0 - na_items = 0 - - # Skip table names - for row in reader: - if len(row[0]) == 0: - break - - # Count items - for row in reader: - if len(row[0]) > 0: - total_items += 1 - if ":done:" in row[2] or ":done:" in row[3]: - done_items += 1 - if ":partial:" in row[2] or ":partial:" in row[3]: - partial_items += 1 - if ":na:" in row[2] or ":na:" in row[3]: - na_items += 1 - - counts = (done_items, - partial_items, - total_items - (partial_items + done_items + na_items), - na_items) - - return list(i / total_items for i in counts) - -def read_table_titles(reader): - r"""Create a dictionary with keys as section names and values as a list of - table names - - return (dict) - """ - section_titles = [] - table_names = {} - try: - for row in reader: - names = [] - # End of names table - if len(row[0]) == 0: - break - # Extract names of the tables - for name in row[1:]: - if len(name) > 0: - names.append(name) - else: - break - section_titles.append(row[0]) - table_names[row[0]] = names - except csv.Error as e: - sys.exit('line %d: %s' % (reader.line_num, e)) - - return section_titles,table_names - -def table_seperator(stream,lengths,character="-"): - r"""Write out table row seperator - - :Input: - - *stream* (io/stream) Stream where output is put - - *lengths* (list) A list of the lengths of the columns - - *character* (string) Character to be filled between +, defaults to "-". - - """ - stream.write("+") - stream.write('+'.join([character*(length+2) for length in lengths])) - stream.write("+") - -def table_row(stream,data,lengths,num_columns=None): - r"""Write out table row data - - :Input: - - *stream* (io/stream) Stream where output is put - - *data* (list) List of strings containing data - - *lengths* (list) A list of the lengths of the columns - - *num_columns* (string) Number of columns, defaults to the length of the - data array - - """ - if num_columns is None: - num_columns = len(data) - stream.write("|") - for i in range(num_columns): - if len(data)-1 >= i: - if len(data[i]) == 0: - entry = MISSING_STRING - else: - entry = data[i] - else: - entry = MISSING_STRING - stream.write(" " + entry + " "*(lengths[i] - len(entry)) + " |") - -def generate_table(reader,stream,table_name=None, - column_titles=["Functionality","Matlab","Scipy","Scipy"]): - r"""Generate a reST grid table based on the CSV data in reader - - Reads CSV data from *reader* until an empty line is found and generates a - reST table based on the data into *stream*. A table name can be given for - a section and table label. All rows are read in and checked for maximum - number of columns (defaults to the size of column_titles) and column - widths so that the table can be constructed. If a row contains less than - the maximum number of columns a string is inserted that defaults to the - string *MISSING_STRING* which is a global parameter. - - :Input: - - reader (csv.reader) The CSV reader to read in from - - stream (iostream) Output target - - table_name (string) Optional name of table, defaults to *None* - - column_titles (list) List of column titles - - """ - # Find number of columns and column widths, base number of columns is - # determined by the headers - num_columns = len(column_titles) - data = [column_titles] - try: - for row in reader: - if len(row[0]) == 0: - break - data.append([entry.expandtabs() for entry in row]) - num_columns = max(num_columns,len(row)) - except csv.Error as e: - sys.exit('line %d: %s' % (reader.line_num, e)) - - column_lengths = [len(MISSING_STRING)]*num_columns - for row in data: - for i in range(len(row)): - column_lengths[i] = max(column_lengths[i],len(row[i])) - - # Output table header - stream.write(table_name + "\n") - if table_name is not None: - stream.write("~"*len(table_name)+"\n\n") - stream.write(".. tabularcolumns:: |p{40%}|p{20%}|p{20%}|p{20%}|\n\n") - if table_name is not None: - stream.write(".. table::%s\n\n" % table_name) - table_seperator(stream,column_lengths,character="-") - stream.write("\n") - table_row(stream,data[0],column_lengths,num_columns) - stream.write("\n") - table_seperator(stream,column_lengths,character="=") - stream.write("\n") - - # Output table data - for row in data[1:]: - table_row(stream,row,column_lengths,num_columns) - stream.write("\n") - table_seperator(stream,column_lengths,character='-') - stream.write("\n") - stream.write("\n\n") - -def generate_page(csv_path,stream,page_title="Coverage Tables"): - r"""Generate coverage table page - - Generates all reST for all tables contained in the CSV file at *csv_path* - and output it to *stream*. - - :Input: - - *csv_path* (path) Path to CSV file - - *stream* (iostream) Output stream - - *page_title* (string) Optional page title, defaults to - ``Coverage Tables``. - """ - # Open reader - csv_file = open(csv_path,'U') - - # Sniffer does not seem to work all the time even when an Excel - # spread sheet is being used - # dialect = csv.Sniffer().sniff(csv_file.read(1024)) - # csv_file.seek(0) - # reader = csv.reader(csv_file, dialect) - - reader = csv.reader(csv_file) - item_counts = calculate_coverage(reader) - csv_file.seek(0) - - # Write out header - stream.write("%s\n" % page_title) - stream.write("="*len(page_title) + "\n\n") - stream.write(""" - -.. role:: missing -.. role:: partial -.. role:: done -.. role:: na -.. role:: missing-bar -.. role:: partial-bar -.. role:: done-bar -.. role:: na-bar - -.. warning:: - - This table has not yet been updated. We've just finished - setting up its structure. - -Color Key ---------- -:done:`Complete` :partial:`Partial` :missing:`Missing` :na:`Not Applicable` - -Coverage Bar ------------- - -.. raw:: html - - - - """) - - for item, style in enumerate(('done-bar', 'partial-bar', - 'missing-bar', 'na-bar')): - stream.write('' % \ - (item_counts[item] * 100, style)) - - stream.write("
 
\n\n") - - sections,table_names = read_table_titles(reader) - for section_name in sections: - stream.write(section_name + "\n") - stream.write("-"*len(section_name) + "\n\n") - for table_name in table_names[section_name]: - generate_table(reader,stream,table_name) - - csv_file.close() - -if __name__ == "__main__": - csv_path = './coverage.csv' - output_path = './coverage_table.txt' - if len(sys.argv) > 1: - if sys.argv[1][:5].lower() == "help": - print("Coverage Table Generator: coverage_generator.py") - print(" Usage: coverage_generator.py [csv] [output]") - print(" csv - Path to csv file, defaults to ./coverage.csv") - print(" output - Ouput path, defaults to ./coverage_table.txt") - print('') - sys.exit(0) - if len(sys.argv) == 2: - csv_path = os.path.abspath(sys.argv[1]) - if len(sys.argv) == 3: - output_path = os.path.abspath(sys.argv[2]) - - output = open(output_path,'w') - generate_page(csv_path,output) - output.close() - - print("Generated %s from %s." % (output_path,csv_path)) - - diff --git a/doc/source/index.txt b/doc/source/index.txt index 93fb259a..086fc246 100644 --- a/doc/source/index.txt +++ b/doc/source/index.txt @@ -2,9 +2,9 @@ skimage |version| docs **************************** -This SciKit_ is an image processing toolbox for SciPy_. +Scikit-image is an image processing toolbox for SciPy_. `View the |version| +release notes here `_. -.. _SciKit: http://scikits.appspot.com .. _SciPy: http://www.scipy.org @@ -22,6 +22,7 @@ Sections contribute license auto_examples/index + release_notes_and_installation .. list-table:: diff --git a/doc/source/release_notes_and_installation.txt b/doc/source/release_notes_and_installation.txt new file mode 100644 index 00000000..f07fd101 --- /dev/null +++ b/doc/source/release_notes_and_installation.txt @@ -0,0 +1,14 @@ +.. |nbsp| unicode:: 0xA0 + :trim: + +.. contents:: |nbsp| + +Release notes +============= + +.. include:: ../release/_release_notes_for_docs.txt + +Installation +============ + +.. include:: install.txt