Skip to content

Commit 3ac3f7c

Browse files
committed
changing readme and fotos
1 parent b09153c commit 3ac3f7c

File tree

2 files changed

+46
-178
lines changed

2 files changed

+46
-178
lines changed

README.md

Lines changed: 46 additions & 178 deletions
Original file line numberDiff line numberDiff line change
@@ -4,202 +4,70 @@
44
<img src="/branding/logo/primary/outdpik.png" width="300">
55
</h1><br>
66

7-
## Main Features
8-
9-
- It supports numpy arrays and pandas dataframes
10-
- Multiple outlier detection techniques that can be combined
11-
- Power full visualizations
12-
13-
14-
# Dillinger
15-
## _The Last Markdown Editor, Ever_
16-
17-
[![N|Solid](https://cldup.com/dTxpPi9lDf.thumb.png)](https://nodesource.com/products/nsolid)
18-
19-
[![Build Status](https://travis-ci.org/joemccann/dillinger.svg?branch=master)](https://travis-ci.org/joemccann/dillinger)
20-
21-
Dillinger is a cloud-enabled, mobile-ready, offline-storage compatible,
22-
AngularJS-powered HTML5 Markdown editor.
23-
24-
- Type some Markdown on the left
25-
- See HTML in the right
26-
- ✨Magic ✨
27-
28-
## Features
29-
30-
- Import a HTML file and watch it magically convert to Markdown
31-
- Drag and drop images (requires your Dropbox account be linked)
32-
- Import and save files from GitHub, Dropbox, Google Drive and One Drive
33-
- Drag and drop markdown and HTML files into Dillinger
34-
- Export documents as Markdown, HTML and PDF
35-
36-
Markdown is a lightweight markup language based on the formatting conventions
37-
that people naturally use in email.
38-
As [John Gruber] writes on the [Markdown site][df1]
39-
40-
> The overriding design goal for Markdown's
41-
> formatting syntax is to make it as readable
42-
> as possible. The idea is that a
43-
> Markdown-formatted document should be
44-
> publishable as-is, as plain text, without
45-
> looking like it's been marked up with tags
46-
> or formatting instructions.
47-
48-
This text you see here is *actually- written in Markdown! To get a feel
49-
for Markdown's syntax, type some text into the left window and
50-
watch the results in the right.
51-
52-
## Tech
7+
# outdpik: Fundamental toolkit for outlier analysis and visualization
538

54-
Dillinger uses a number of open source projects to work properly:
9+
[![PyPI Latest Release](https://img.shields.io/pypi/v/outdpik.svg)](https://pypi.org/project/outdpik/)
10+
[![PyPI License](https://img.shields.io/pypi/l/jMetalPy.svg)](license.txt)
11+
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
5512

56-
- [AngularJS] - HTML enhanced for web apps!
57-
- [Ace Editor] - awesome web-based text editor
58-
- [markdown-it] - Markdown parser done right. Fast and easy to extend.
59-
- [Twitter Bootstrap] - great UI boilerplate for modern web apps
60-
- [node.js] - evented I/O for the backend
61-
- [Express] - fast node.js network app framework [@tjholowaychuk]
62-
- [Gulp] - the streaming build system
63-
- [Breakdance](https://breakdance.github.io/breakdance/) - HTML
64-
to Markdown converter
65-
- [jQuery] - duh
66-
67-
And of course Dillinger itself is open source with a [public repository][dill]
68-
on GitHub.
69-
70-
## Installation
71-
72-
Dillinger requires [Node.js](https://nodejs.org/) v10+ to run.
73-
74-
Install the dependencies and devDependencies and start the server.
75-
76-
```sh
77-
cd dillinger
78-
npm i
79-
node app
80-
```
81-
82-
For production environments...
83-
84-
```sh
85-
npm install --production
86-
NODE_ENV=production node app
87-
```
88-
89-
## Plugins
90-
91-
Dillinger is currently extended with the following plugins.
92-
Instructions on how to use them in your own application are linked below.
93-
94-
| Plugin | README |
95-
| ------ | ------ |
96-
| Dropbox | [plugins/dropbox/README.md][PlDb] |
97-
| GitHub | [plugins/github/README.md][PlGh] |
98-
| Google Drive | [plugins/googledrive/README.md][PlGd] |
99-
| OneDrive | [plugins/onedrive/README.md][PlOd] |
100-
| Medium | [plugins/medium/README.md][PlMe] |
101-
| Google Analytics | [plugins/googleanalytics/README.md][PlGa] |
102-
103-
## Development
13+
## What is it?
14+
Outdpik is an open source Python package that provides different methods for outlier detection.
15+
It aims to be the fundamental high-level package for this purpose.
16+
Additionally, it offers visualization methods for the outlier analysis.
10417

105-
Want to contribute? Great!
106-
107-
Dillinger uses Gulp + Webpack for fast developing.
108-
Make a change in your file and instantaneously see your updates!
109-
110-
Open your favorite Terminal and run these commands.
111-
112-
First Tab:
113-
114-
```sh
115-
node app
116-
```
117-
118-
Second Tab:
119-
120-
```sh
121-
gulp watch
122-
```
123-
124-
(optional) Third:
18+
## Main Features
19+
Here are just a few of the things that outdpik does well:
12520

126-
```sh
127-
karma test
128-
```
21+
- It supports numpy arrays and pandas dataframes
22+
- Multiple outlier detection techniques that can be combined
23+
- Powerful visualizations
24+
- Flexible at including one or more columns for the analysis
12925

130-
#### Building for source
26+
## Where to get it
27+
The source code is currently hosted on GitHub at:
28+
https://github.com/DanielPuentee/outdpik
13129

132-
For production release:
30+
Installer for the latest released version is available at the [Python
31+
Package Index (PyPI)](https://pypi.org/project/outdpik)
13332

13433
```sh
135-
gulp build --prod
34+
# PyPI
35+
pip install outdpik
13636
```
13737

138-
Generating pre-built zip archives for distribution:
38+
## How to use outdpik 🤙
39+
Examples of configuring and running outpdik:
13940

140-
```sh
141-
gulp build dist --prod
41+
```python
42+
import outpdik as outdp
43+
outdp = outdp()
14244
```
14345

144-
## Docker
145-
146-
Dillinger is very easy to install and deploy in a Docker container.
147-
148-
By default, the Docker will expose port 8080, so change this within the
149-
Dockerfile if necessary. When ready, simply use the Dockerfile to
150-
build the image.
46+
We proceed to detect outliers returning a dictionary of numeric features and the outliers instances:
15147

152-
```sh
153-
cd dillinger
154-
docker build -t <youruser>/dillinger:${package.json.version} .
48+
```python
49+
outliers_dict = outdp.outliers(df = df, cols = "all")
15550
```
51+
Plotting advantages:
15652

157-
This will create the dillinger image and pull in the necessary dependencies.
158-
Be sure to swap out `${package.json.version}` with the actual
159-
version of Dillinger.
160-
161-
Once done, run the Docker image and map the port to whatever you wish on
162-
your host. In this example, we simply map port 8000 of the host to
163-
port 8080 of the Docker (or whatever port was exposed in the Dockerfile):
164-
165-
```sh
166-
docker run -d -p 8000:8080 --restart=always --cap-add=SYS_ADMIN --name=dillinger <youruser>/dillinger:${package.json.version}
53+
```python
54+
outdp.plot_outliers(df = df, col = "x")
16755
```
56+
<img src=branding/logo/primary/graph.png width=450 alt="Strip plot outliers detection">
16857

169-
> Note: `--capt-add=SYS-ADMIN` is required for PDF rendering.
170-
171-
Verify the deployment by navigating to your server address in
172-
your preferred browser.
173-
174-
```sh
175-
127.0.0.1:8000
176-
```
58+
## Dependencies
59+
- [pandas - Provides fast, flexible, and expressive data structures designed to make working with "relational" or "labeled" data both easy and intuitive](https://pandas.pydata.org/)
60+
- [NumPy - Adds support for large, multi-dimensional arrays, matrices and high-level mathematical functions to operate on these arrays](https://www.numpy.org)
61+
- [SciPy - Includes modules for statistics, optimization, integration, linear algebra, Fourier transforms, signal and image processing, ODE solvers, and more](https://scipy.org/)
62+
- [matplotlib - Comprehensive library for creating static, animated, and interactive visualizations in Python](https://matplotlib.org/)
63+
- [seaborn - Provides a high-level interface for drawing attractive statistical graphics](https://seaborn.pydata.org/)
17764

17865
## License
66+
This project is licensed under the terms of the [MIT](license.txt) - see the LICENSE file for details.
17967

180-
MIT
181-
182-
**Free Software, Hell Yeah!**
183-
184-
[//]: # (These are reference links used in the body of this note and get stripped out when the markdown processor does its job. There is no need to format nicely because it shouldn't be seen. Thanks SO - http://stackoverflow.com/questions/4823468/store-comments-in-markdown-syntax)
185-
186-
[dill]: <https://github.com/joemccann/dillinger>
187-
[git-repo-url]: <https://github.com/joemccann/dillinger.git>
188-
[john gruber]: <http://daringfireball.net>
189-
[df1]: <http://daringfireball.net/projects/markdown/>
190-
[markdown-it]: <https://github.com/markdown-it/markdown-it>
191-
[Ace Editor]: <http://ace.ajax.org>
192-
[node.js]: <http://nodejs.org>
193-
[Twitter Bootstrap]: <http://twitter.github.com/bootstrap/>
194-
[jQuery]: <http://jquery.com>
195-
[@tjholowaychuk]: <http://twitter.com/tjholowaychuk>
196-
[express]: <http://expressjs.com>
197-
[AngularJS]: <http://angularjs.org>
198-
[Gulp]: <http://gulpjs.com>
199-
200-
[PlDb]: <https://github.com/joemccann/dillinger/tree/master/plugins/dropbox/README.md>
201-
[PlGh]: <https://github.com/joemccann/dillinger/tree/master/plugins/github/README.md>
202-
[PlGd]: <https://github.com/joemccann/dillinger/tree/master/plugins/googledrive/README.md>
203-
[PlOd]: <https://github.com/joemccann/dillinger/tree/master/plugins/onedrive/README.md>
204-
[PlMe]: <https://github.com/joemccann/dillinger/tree/master/plugins/medium/README.md>
205-
[PlGa]: <https://github.com/RahulHP/dillinger/blob/master/plugins/googleanalytics/README.md>
68+
## Documentation
69+
The official documentation is hosted on FALTA: https://pandas.pydata.org/pandas-docs/stable
70+
71+
## Development
72+
Want to contribute? Great!
73+
Open a discussion in Github in this repo and we will answer as soon as possible.

branding/logo/primary/graph.png

30.6 KB
Loading

0 commit comments

Comments
 (0)